Base

You can run a Base Network MCP Server that lets large language models perform wallet management, balance checks, and transactions on Base Mainnet or Sepolia testnet through natural language commands. This server bridges LLM capabilities with blockchain actions in a secure, configurable way, enabling you to orchestrate Base network operations from your preferred MCP client.

How to use

Connect your MCP client to the Base Network MCP Server using the stdio transport (local process) or any transport your client supports. You interact with tools through natural language commands, such as creating wallets, checking balances, or sending funds.

Available tools include creating wallets, checking a wallet balance, listing wallets, and processing arbitrary Base network commands. Examples of typical workflows you can perform include creating a new wallet for savings, checking the balance of a wallet, and sending Base ETH (or equivalent) to another address.

To execute commands, your MCP client calls the process_command tool with a natural language command. The server returns structured results containing operation details such as wallet addresses, balances, or transaction information. You can manage multiple wallets, inspect balances, and perform transfers through straightforward commands.

How to install

Prerequisites you need before installation: Node.js and npm (or a compatible package manager). Make sure you have network access to fetch packages.

Install the Base Network MCP Server package using your preferred package manager.

npm i base-network-mcp-server
# or
yarn add base-network-mcp-server
# or
pnpm add base-network-mcp-server

Additional sections

Configuration and runtime details help you tailor the server to your environment and security needs. The server supports running in a local stdio mode or connecting via HTTP endpoints when available.

Example startup using stdio transport with environment variables for provider access and wallet signing:

BASE_PROVIDER_URL="https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY"\nWALLET_PRIVATE_KEY="your_private_key_here"\nnpx -y base-network-mcp-server

Security considerations

Protect private keys and API keys. Use the Sepolia testnet for testing before moving to mainnet. Validate all command parameters before execution and implement robust error handling and rate limiting to handle network variability.

Example commands

Create a new wallet for savings, check wallet balance, or send funds using natural language commands such as “Create a new wallet for savings” or “Send 0.1 ETH to 0x1234...”. You can also query balances like “What is the balance of my savings wallet?” and list all wallets with “List wallets.”

Available tools

process_command

Processes a natural language command for Base network operations, returning structured results such as transaction details, balance information, and wallet details.

create_wallet

Creates a new wallet on the Base network and returns the wallet address, name, and related details.

check_balance

Checks and returns the balance of a specified wallet or the primary wallet on the Base network.

list_wallets

Lists all available wallets with their addresses and details.