1. Conduid
  2. Blockchain
  3. Basescan MCP Server
MCP server · Blockchain

Basescan MCP Server

by · github.com/u-Operating-System/basescan-mcp-server

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

Unclaimed last commit a year ago blockchain
InstallView source
34Low

Scored 7 months ago · breakdown

About Basescan MCP Server

Basescan MCP Server is an MCP server published by u-Operating-System in the Blockchain category: mCP server for AI agents to query Base Network blockchain data.

The repository has 4 stars and 1 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/u-Operating-System/basescan-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (9)

check_contractSmart contract detection

Parameters not published.

get_account_tokensToken transfer history

Parameters not published.

get_account_transactionsAccount transaction history

Parameters not published.

get_balanceETH balance lookup

Parameters not published.

get_blockBlock by number/hash

Parameters not published.

get_gas_priceCurrent gas prices

Parameters not published.

get_latest_blockLatest block information

Parameters not published.

get_network_statsNetwork statistics

Parameters not published.

get_transactionTransaction details

Parameters not published.

Ask AI

✦

Ask AI about Basescan MCP Server

Powered by Claude · Grounded in docs

I know everything about Basescan MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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

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

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Basescan MCP Server

How do I install Basescan MCP Server?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Basescan MCP Server safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Basescan MCP Server still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.