Base Network MCP Server

What is Base Network MCP Server?

A Model Context Protocol server that provides tools for querying blockchain data on Base Network, including blocks, transactions, balances, and smart contracts on both Base mainnet and Sepolia testnet.

How to use Base Network MCP Server?

Clone the repository, run npm install and npm build, then start with npm start for stdio mode or MCP_TRANSPORT_TYPE=http npm start for HTTP. Optionally set a BaseScan API key via the BASESCAN_API_KEY environment variable. Configure Claude Desktop by adding a JSON entry to claude_desktop_config.json.

Key features of Base Network MCP Server

• 9 blockchain tools, 7 work without an API key
• Supports Base mainnet and Sepolia testnet
• Real-time blockchain data access
• Docker support for containerized deployment
• Multiple transport options: stdio and HTTP

Use cases of Base Network MCP Server

• Retrieve the latest block or a specific block by number/hash
• Look up transaction details by hash
• Check ETH balance for any address
• Monitor current gas prices on Base Network
• Verify if an address is a smart contract
• Query account transaction or token transfer history (requires API key)

FAQ from Base Network MCP Server

What tools are available without an API key?

Seven tools: get_latest_block, get_block, get_transaction, get_balance, get_gas_price, check_contract, and get_network_stats.

How do I get a BaseScan API key?

Visit https://basescan.org/apis, create an account, obtain an API key, and set it as the BASESCAN_API_KEY environment variable.

What networks does the server support?

Base Mainnet (chain ID 8453) and Base Sepolia (chain ID 84532).

How can I run the server in HTTP mode?

Set the environment variable MCP_TRANSPORT_TYPE=http and optionally configure MCP_HTTP_PORT (default 3010), then start the server.

Is Docker supported?

Yes. Use docker run -p 3010:3010 basescan-mcp-server and optionally add -e BASESCAN_API_KEY=your-key for enhanced features.