Linea MCP Server

What is Linea MCP Server?

Linea MCP Server is a Model Context Protocol (MCP) server that provides on-chain tools for AI applications to interact with the Linea blockchain, an Ethereum Layer 2 scaling solution using zero-knowledge proof technology. It enables AI assistants like Claude, Cursor, and other MCP-compatible clients to perform blockchain operations through natural language requests.

How to use Linea MCP Server?

Install globally via npm install -g linea-mcp or from source by cloning the repository and running npm install. Configure environment variables (RPC URLs, wallet private key, Infura API key) in a .env file. Integrate with any MCP-compatible client by editing the client’s MCP configuration file (e.g., mcp.json for Cursor or claude_desktop_config.json for Claude Desktop) and adding a linea server entry using either the global npx approach or a local Node.js path.

Key features of Linea MCP Server

• Wallet management: retrieve addresses and check balances
• Token operations: transfer ERC20 tokens, check balances, list tokens
• Smart contract interactions: deploy and call contracts
• NFT management: list and transfer NFTs
• Bridge operations: bridge assets between Ethereum and Linea
• DeFi integrations: interact with liquidity pools, swaps, yield farming
• Verax integration: verify identity with Linea Verax attestations
• Linea ENS: resolve and manage Linea ENS names

Use cases of Linea MCP Server

• Query blockchain data and wallet balances via natural language
• Transfer ERC20 tokens or NFTs using an AI assistant
• Deploy and interact with smart contracts without manual RPC calls
• Bridge assets between Ethereum mainnet and Linea
• Verify on-chain identity or manage Linea ENS names

FAQ from Linea MCP Server

What are the prerequisites to run the server?

Node.js v16+, npm or yarn, and access to Linea RPC endpoints (mainnet or testnet).

How do I install and configure the server?

Install globally with npm install -g linea-mcp, create a .env file with your RPC URLs, wallet private key, and Infura API key, then run linea-mcp. Alternatively, clone the repo, install dependencies, build, and run node dist/index.js.

How do I integrate Linea MCP Server with my AI client?

Find your client’s MCP configuration file (e.g., for Cursor: mcp.json, for Claude Desktop: claude_desktop_config.json) and add a linea server entry with the appropriate command, args, and environment variables. Use npx linea-mcp@latest for simple setups or a local path to the built index.js for development.

What should I do if I see “No tools available” or “Client closed” errors?

Use direct Node.js execution ("command": "node", "args": ["/path/to/dist/index.js"]) instead of npm scripts, ensure all environment variables are set correctly, and restart the client after configuration changes.

Where are the configuration files located for popular clients?

For Cursor: %APPDATA%\Cursor\mcp.json (Windows), ~/Library/Application Support/Cursor/mcp.json (macOS), ~/.config/Cursor/mcp.json (Linux). For Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json (Windows), ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), ~/.config/Claude/claude_desktop_config.json (Linux). For other clients, refer to their documentation.