Base Network MCP Server

by u-Operating-System

221 downloads Not rated yet MIT license
GitHub

About

MCP server for AI agents to query Base Network blockchain data.

Details

License
MIT license

Explore

- 9 blockchain tools (7 work without API key)
- Base mainnet and Sepolia testnet support
- Real-time blockchain data access
- Docker support
- Multiple transport options (stdio, HTTP)

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 Network MCP Server
    Command (node, npx, python, etc.)

    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

Configure via environment variables:

NODE_ENV=development              # development|production
MCP_TRANSPORT_TYPE=stdio          # stdio|http
MCP_HTTP_PORT=3010               # HTTP port
BASESCAN_API_KEY=your-key        # BaseScan API key (optional)
MCP_LOG_LEVEL=info               # debug|info|warning|error
git clone https://github.com/u-Operating-System/basescan-mcp-server.git
cd basescan-mcp-server
npm install
npm run build

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "base-network": {
      "command": "node",
      "args": ["/path/to/basescan-mcp-server/build/index.js"],
      "env": {
        "BASESCAN_API_KEY": "your-key-here"
      }
    }
  }
}

docker run -p 3010:3010 basescan-mcp-server

get_latest_block

Latest block information

get_block

Block by number/hash

get_transaction

Transaction details

get_balance

ETH balance lookup

get_gas_price

Current gas prices

check_contract

Smart contract detection

get_network_stats

Network statistics

get_account_transactions

Account transaction history

get_account_tokens

Token transfer history

| Tool | Description | Requires API Key |
|------|-------------|------------------|
| get_latest_block | Latest block information | No |
| get_block | Block by number/hash | No |
| get_transaction | Transaction details | No |
| get_balance | ETH balance lookup | No |
| get_gas_price | Current gas prices | No |
| check_contract | Smart contract detection | No |
| get_network_stats | Network statistics | No |
| get_account_transactions | Account transaction history | Yes |
| get_account_tokens | Token transfer history | Yes |

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "base network mcp server": {
            "basescan-mcp-server": {
                "command": "docker",
                "args": [
                    "run",
                    "-p",
                    "3010:3010",
                    "basescan-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "basescan-mcp-server": {
        "command": "docker",
        "args": [
            "run",
            "-p",
            "3010:3010",
            "basescan-mcp-server"
        ]
    }
}

A Model Context Protocol (MCP) server for accessing Base Network blockchain data. Provides tools for querying blocks, transactions, balances, and smart contracts on Base mainnet and testnet.

Features

- 9 blockchain tools (7 work without API key)
- Base mainnet and Sepolia testnet support
- Real-time blockchain data access
- Docker support
- Multiple transport options (stdio, HTTP)

Quick Start

Install and Build

git clone https://github.com/u-Operating-System/basescan-mcp-server.git
cd basescan-mcp-server
npm install
npm run build

Run the Server

```bash

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.