Base Network MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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)
Related MCP server: BaseQL MCP Server
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 buildRun the Server
# For Claude Desktop (recommended)
npm start
# For HTTP server
MCP_TRANSPORT_TYPE=http npm startOptional: BaseScan API Key
Get enhanced features by adding a free BaseScan API key:
Create account and get API key
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-serverAvailable Tools
Tool | Description | Requires API Key |
| Latest block information | No |
| Block by number/hash | No |
| Transaction details | No |
| ETH balance lookup | No |
| Current gas prices | No |
| Smart contract detection | No |
| Network statistics | No |
| Account transaction history | Yes |
| 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|errorSecurity
Store API keys in environment variables
Never commit
.envfiles with real valuesUse 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 formattingLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
On-chain receipts, balances, tx status and address activity, pay-per-call via x402 USDC on Base.
Live Base Mainnet on-chain data (gas, DEX, Aave, token risk, prices). Pay per call in USDC via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables blockchain payment operations across multiple networks including Base, Ethereum, BSC, Polygon, and Avalanche. Supports balance queries, token transfers, transaction tracking, wallet management, and gas fee estimation with built-in security limits.MIT
- AlicenseNot gradedqualityDmaintenanceEnables agents to query Base blockchain data using natural language by providing contract addresses, SQL templates, and direct access to Coinbase's SQL API for realtime on-chain analytics including DeFi, NFTs, and wallet activity.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Base Network blockchain data including blocks, transactions, balances, and smart contracts on mainnet and testnet.MIT
- AlicenseAqualityCmaintenanceRead-only on-chain intelligence for AI agents on Base, providing tools to read balances, token metadata, gas, and transaction status live from chain without API keys.5MIT