basescan-mcp-server

u-Operating-System/basescan-mcp-server

3.3

If you are the rightful owner of basescan-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

Tools
  1. get_latest_block

    Latest block information

  2. get_block

    Block by number/hash

  3. get_transaction

    Transaction details

  4. get_balance

    ETH balance lookup

  5. get_gas_price

    Current gas prices

  6. check_contract

    Smart contract detection

  7. get_network_stats

    Network statistics

  8. get_account_transactions

    Account transaction history

  9. get_account_tokens

    Token transfer history

Base Network 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

# For Claude Desktop (recommended)
npm start

# For HTTP server
MCP_TRANSPORT_TYPE=http npm start

Optional: BaseScan API Key

Get enhanced features by adding a free BaseScan API key:

  1. Visit https://basescan.org/apis
  2. Create account and get API key
  3. Add to environment: BASESCAN_API_KEY=your-key

Claude Desktop Setup

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

# Basic setup
docker run -p 3010:3010 basescan-mcp-server

# With API key
docker run -p 3010:3010 -e BASESCAN_API_KEY=your-key basescan-mcp-server

Available Tools

ToolDescriptionRequires API Key
get_latest_blockLatest block informationNo
get_blockBlock by number/hashNo
get_transactionTransaction detailsNo
get_balanceETH balance lookupNo
get_gas_priceCurrent gas pricesNo
check_contractSmart contract detectionNo
get_network_statsNetwork statisticsNo
get_account_transactionsAccount transaction historyYes
get_account_tokensToken transfer historyYes

Configuration

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

Security

  • Store API keys in environment variables
  • Never commit .env files with real values
  • Use HTTPS in production

Networks

  • Base Mainnet: Chain ID 8453
  • Base Sepolia: Chain ID 84532

Development

npm run dev            # Development with hot reload
npm test               # Run tests
npm run lint           # Code linting
npm run format         # Code formatting

License

MIT