MCP Integration

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI applications to connect with external data sources and tools through a unified interface. It provides a standardized way for LLMs to access real-time data, execute actions, and interact with APIs — without custom integrations for each client.

Chainbase MCP Server

The Chainbase MCP Server allows any MCP-compatible AI client (such as Claude Desktop, Cursor, Windsurf, and others) to directly access Chainbase’s Web3 data — enabling queries like token balances, NFT ownership, transaction history, and on-chain analytics through natural language.

Capabilities

Token Data — Query token prices, holders, metadata, and transfers
Wallet Analytics — Check balances, transaction history, and portfolio analysis
NFT Exploration — Browse collections, ownership, rarity, and transfer history
Block/Tx Detail — Get block details, and transaction information

Base Endpoint:

https://api.chainbase.com/v1/mcp

Authentication:

X-API-KEY: <your_api_key>

Transport

Chainbase MCP uses standard HTTP transport.

Method: POST
Content-Type: application/json
Auth Header: X-API-KEY

Example raw request:

curl https://api.chainbase.com/v1/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{ "jsonrpc":"2.0", "id":1, "method":"tools/list" }'

Manual Setup

ClaudeCode
ClaudeDesktop
Codex
Cursor
Other Clients

claude mcp add --transport http chainbase https://api.chainbase.com/v1/mcp --header "X-API-KEY: your-actual-api-key"

edit Claude Desktop config file:

# On MacOS:
vim ~/Library/Application Support/Claude/claude_desktop_config.json
# On Windows:
notepad "%APPDATA%\Claude\claude_desktop_config.json"
# On Linux:
vim ~/.config/Claude/claude_desktop_config.json

add the MCP server configuration:

{
    "mcpServers": {
        "chainbase": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://api.chainbase.com/v1/mcp",
                "--header",
                "X-API-KEY:${API_KEY}",
                "--transport",
                "http-only"
            ],
            "env": {
                "API_KEY": "your-actual-api-key"
            }
        }
    }
}

add MCP server information to ~/.codex/config.toml:

[mcp_servers.chainbase]
url = "https://api.chainbase.com/v1/mcp"
http_headers = { "X-API-KEY" = "<your-api-key>" }

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
    "mcpServers": {
        "chainbase": {
            "url": "https://api.chainbase.com/v1/mcp",
            "headers": {
                "X-API-KEY": "your-actual-api-key"
            }
        }
    }
}

Configure your MCP client to connect to https://api.chainbase.com/v1/mcp and include your API key in the X-API-KEY request header.Most MCP clients support HTTP transport with custom headers. Ensure the base URL is set to the endpoint above and add: X-API-KEY: <your_api_key>Refer to your specific MCP client documentation for instructions on configuring HTTP transport and custom headers.

Don’t have an API key? Go to console.chainbase.com to create an account and a new API key. For demo purposes, you can use the key “demo” to test out the API.

Explorer Tools

Tool	Description
GetLastBlockNumber	get the latest block number
GetBlock	get block details by number
GetTx	get transaction details by hash or block number and index
GetAccountBalance	get account native balance or contract token balance
GetAccountNFTs	get account nfts
GetAccountTokens	get account token balances
GetAccountTxs	get account transactions
GetTokenHolders	get token holders addresses
GetTokenMeta	get token metadata
GetTokenPrice	get token price
GetTokenTopHolders	get token top holders addresses, returns original balance and usd value
GetTokenTransfers	get token transfers
GetNFTMeta	get nft metadata
GetNFTOwner	get nft owner by contract and token id
GetNFTOwnerHistory	get nft owner histories by contract and token id
GetNFTOwners	list nft owners by contract address
GetNFTTransfers	get nft transfers

Stay Updated

Follow Chainbase on X for release announcements
Join the Chainbase Discord community
Star the GitHub repo to get notified

Chainbase AI

Payments

Agent Skills

CLI Tools

Integrations

What is MCP?

Chainbase MCP Server

Capabilities

Transport

Manual Setup

Explorer Tools

Stay Updated

Chainbase AI

Payments

Agent Skills

CLI Tools

Integrations

​What is MCP?

​Chainbase MCP Server

​Capabilities

​Transport

​Manual Setup

​Explorer Tools

​Stay Updated

What is MCP?

Chainbase MCP Server

Capabilities

Transport

Manual Setup

Explorer Tools

Stay Updated