base

The base MCP server provides a set of tools that allow LLMs and clients to interact with the Base network through natural language commands. Core capabilities include creating wallets, checking balances, processing arbitrary Base network commands (such as transfers), and listing all wallets. The server is designed to work with both Base Mainnet and Base Sepolia testnet, enabling development and production workflows. When connected to an MCP client (for example via a StreamTransport or other MCP SDK transport), you can call tools like process_command, create_wallet, check_balance, and list_wallets to perform blockchain operations without writing low-level RPC calls.

To use it with Claude Desktop or other MCP clients, configure the client to connect to the server using the MCP setup described in the installation guide. For Claude Desktop, add the server under mcpServers in your config with the command, arguments, and required environment variables. You can then issue natural language requests such as: "Create a new wallet for savings", "Check my wallet balance", or "Send 0.1 ETH to 0x...". The server will translate these into Base network actions and return structured results like balances, wallet details, or transaction information.

Prerequisites:

• Node.js (LTS) and npm or pnpm/yarn installed on your system
• Internet access to fetch the MCP server package

Step 1: Install Node.js prerequisites

• Visit https://nodejs.org/ and install the latest LTS release suitable for your OS

Step 2: Install the Base MCP Server package Option A (npm):

npm i base-network-mcp-server

Option B (yarn):

yarn add base-network-mcp-server

Option C (pnpm):

pnpm add base-network-mcp-server

Step 3: Run the server using npx with the required configuration

npx -y base-network-mcp-server

Step 4: Configure your MCP client (example for Claude Desktop)

• Create or edit the MCP server entry in the client config to point to the server with the necessary environment variables (BASE_PROVIDER_URL and WALLET_PRIVATE_KEY).

Step 5: Verify installation

• Ensure the server starts without errors and that you can call tools like process_command, create_wallet, check_balance, and list_wallets from your MCP client.

Notes:

• Replace YOUR_API_KEY and your_private_key_here with actual credentials before going to production.
• Consider using Base Sepolia for initial testing before switching to Mainnet.

Environment variables and configuration:

• BASE_PROVIDER_URL: The RPC URL for the Base network (Mainnet or Sepolia). Use a testnet URL during development.
• WALLET_PRIVATE_KEY: Private key used for signing transactions. Keep this secret; never commit to code or public repos.
• DEFAULT_GAS_PRICE: Optional default gas price in Gwei. If omitted, the client/server may query dynamic gas pricing.

Security considerations:

• Never expose private keys in logs or config files in plaintext. Use secure vaults or environment management solutions.
• Prefer testnets for development to avoid loss of funds.
• Validate input and implement error handling to manage network failures gracefully.