Base Blockchain

by fakepixels

2 170 downloads Not rated yet MIT

About

Provides a bridge to the Base blockchain network for wallet management, balance checking, and transaction execution through natural language commands, eliminating the need to manage technical blockchain details.

Details

Repository
fakepixels/base-mcp-server
License
MIT

Explore

- Natural language command processing for blockchain operations.
- Wallet creation, balance checking, and listing wallets.
- Transaction execution (e.g., sending ETH).
- Supports Base Mainnet and Sepolia testnet.
- Configurable provider URL and private key.
- Optional default gas price setting.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Base Blockchain
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 base-network-mcp-server
    Environment
    • BASE_PROVIDER_URL https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY
    • WALLET_PRIVATE_KEY your_private_key_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- BASE_PROVIDER_URL: The URL of the Base network provider (Mainnet or Sepolia)
- WALLET_PRIVATE_KEY: Your wallet private key for authentication and transaction signing
- DEFAULT_GAS_PRICE: (Optional) Default gas price in Gwei

process_command

Processes a natural language command for Base network operations. Parameters: command (string) - The natural language command to process (e.g., 'Send 0.5 ETH to 0x1234...').

create_wallet

Creates a new wallet on the Base network. Parameters: name (optional string) - A name for the wallet.

check_balance

Checks the balance of a wallet on the Base network. Parameters: wallet (optional string) - The wallet name or address to check (defaults to the primary wallet).

list_wallets

Lists all available wallets. Returns an array of wallet objects, each containing the wallet address, name, and other details.

The following tools are available:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "base blockchain": {
            "env": {
                "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
                "WALLET_PRIVATE_KEY": "your_private_key_here"
            },
            "args": [
                "-y",
                "base-network-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
        "WALLET_PRIVATE_KEY": "your_private_key_here"
    },
    "args": [
        "-y",
        "base-network-mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
        "WALLET_PRIVATE_KEY": "your_private_key_here"
    },
    "args": [
        "-y",
        "base-network-mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
        "WALLET_PRIVATE_KEY": "your_private_key_here"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "base-network-mcp-server"
    ],
    "command": "cmd"
}

base-network-mcp-server

This is an MCP server for the Base network. It allows LLMs to perform blockchain operations on the Base network through natural language commands, including wallet management, balance checking, and transaction execution.

This server works with both Base Mainnet and Base Sepolia testnet.

Tools

The following tools are available:

process_command

Processes a natural language command for Base network operations. It accepts the following arguments:

- command: The natural language command to process (e.g., "Send 0.5 ETH to 0x1234...")

It returns a structured response with the result of the operation, including transaction details for send operations, balance information for balance checks, and wallet details for wallet creation.

create_wallet

Creates a new wallet on the Base network. It accepts the following arguments:

- name: (Optional) A name for the wallet

It returns an object containing the wallet address, name, and other details.

check_balance

Checks the balance of a wallet on the Base network. It accepts the following arguments:

- wallet: (Optional) The wallet name or address to check (defaults to the primary wallet)

It returns the wallet balance in ETH.

list_wallets

Lists all available wallets.

It returns an array of wallet objects, each containing the wallet address, name, and other details.

Usage

With Claude Desktop

Claude Desktop is a popular LLM client that supports the Model Context Protocol. You can connect your Base MCP server to Claude Desktop to perform blockchain operations via natural language commands.

You can add MCP servers to Claude Desktop via its config file at:

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

To add your Base MCP server to Claude Desktop, add the following configuration to the mcpServers object in the config file:

{
  "mcpServers": {
    "base": {
      "command": "npx",
      "args": [
        "-y",
        "base-network-mcp-server"
      ],
      "env": {
        "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
        "WALLET_PRIVATE_KEY": "your_private_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Configuration

- BASE_PROVIDER_URL: The URL of the Base network provider (Mainnet or Sepolia)
- WALLET_PRIVATE_KEY: Your wallet private key for authentication and transaction signing
- DEFAULT_GAS_PRICE: (Optional) Default gas price in Gwei

Programmatically (custom MCP client)

If you're building your own MCP client, you can connect to the Base MCP server programmatically using your preferred transport. The MCP SDK offers built-in stdio and SSE transports.

Installation

```bash
npm i base-network-mcp-server

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.