Documentation
Blockchain MCP powered by Tatum
A Model Context Protocol (MCP) server that exposes the Tatum Blockchain Data API and RPC Gateway so LLM clients can query blockchain data across 130+ networks. Get an API key on the Tatum MCP page or dashboard.
Features
- 130+ Blockchain Networks: Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Base, Avalanche, and many more.
- 🔗 **Blockchain Data API**: Blocks, transactions, balances, network info, and more.
- 🌐 **RPC Gateway**: Direct access to blockchain RPC endpoints.
Requires Node.js 18+ and a TATUM_API_KEY.
Installation
npm install -g @tatumio/blockchain-mcpOr use without a global install:
npx @tatumio/blockchain-mcpPublished binaries: blockchain-mcp and blockchain-mcp-server (same entrypoint).
MCP client setup
1. Create a free API key at dashboard.tatum.io.
2. Add the server to your MCP client (Cursor, Claude Desktop, VS Code, etc.):
{
"mcpServers": {
"tatumio": {
"command": "npx",
"args": ["@tatumio/blockchain-mcp"],
"env": {
"TATUM_API_KEY": "YOUR_API_KEY"
}
}
}
}Do not commit API keys. Use environment variables in client config only.
Example prompts
Once connected, you can ask your assistant to use MCP tools, for example:
- “What is the BTC/USD exchange rate?” →
get_exchange_ratewithsymbol: BTC,basePair: USD - “Show Vitalik’s native ETH balance history” →
get_wallet_portfolio/get_transaction_historyonethereum-mainnet - “What is the latest Ethereum block number?” →
gateway_execute_rpcwitheth_blockNumber
Chain identifiers use Tatum gateway names (e.g. ethereum-mainnet, bitcoin-mainnet). Call gateway_get_supported_chains for the live list.
Available tools (13)
Blockchain Data (10)
| Tool | Description |
|---|---|
get_metadata | NFT/multitoken metadata by contract address and token IDs |
get_wallet_balance_by_time | Native wallet balance at a block or timestamp |
get_wallet_portfolio | Wallet portfolio (native, fungible, NFT) |
get_owners | Owners of an NFT or token contract |
check_owner | Whether an address owns a given token |
get_transaction_history | Transaction history for one or more addresses |
get_block_by_time | Block info for a timestamp |
get_tokens | Token metadata (contract address or native) |
check_malicious_address | Security check for a wallet/contract address |
get_exchange_rate | Fiat/crypto rate (e.g. BTC / USD) |
RPC Gateway (3)
| Tool | Description |
|---|---|
gateway_get_supported_chains | All networks available through the gateway |
gateway_get_supported_methods | RPC/REST methods supported for a chain |
gateway_execute_rpc | Run a JSON-RPC method or REST call on a chain |
Supported networks
Tatum supports many EVM and non-EVM chains. Examples:
- EVM: Ethereum (mainnet, Sepolia, Holesky), Polygon, Arbitrum, Optimism, Base, BSC, Avalanche, Fantom, Celo, Gnosis, Ronin, and others.
- Non-EVM: Bitcoin, Litecoin, Dogecoin, Solana, Cardano, Tezos, Stellar, Ripple, and others.
For authoritative chain IDs and RPC coverage, use gateway_get_supported_chains or see Supported blockchains.
Development
git clone https://github.com/tatumio/blockchain-mcp.git
cd blockchain-mcp
npm install
cp .env.example .env # add your TATUM_API_KEY
npm run buildRun the MCP server locally:
export TATUM_API_KEY=your-key
npm start
# or via CLI wrapper:
npx blockchain-mcp --api-key your-keyPoint a local MCP client at the built CLI:
{
"mcpServers": {
"tatumio-local": {
"command": "node",
"args": ["/absolute/path/to/blockchain-mcp/dist/cli.js"],
"env": { "TATUM_API_KEY": "YOUR_API_KEY" }
}
}
}Smoke-test live APIs (requires TATUM_API_KEY):
npm run verify:toolsDocumentation
License
MIT — see LICENSE.
About Tatum
Tatum provides blockchain APIs, SDKs, and infrastructure for developers.
Similar MCP
Based on tags & features
Trending MCP
Most active this week