blockchain-mcp

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-mcp

Or use without a global install:

npx @tatumio/blockchain-mcp

Published 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_rate with symbol: BTC, basePair: USD
• “Show Vitalik’s native ETH balance history” → get_wallet_portfolio / get_transaction_history on ethereum-mainnet
• “What is the latest Ethereum block number?” → gateway_execute_rpc with eth_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 build

Run the MCP server locally:

export TATUM_API_KEY=your-key
npm start
# or via CLI wrapper:
npx blockchain-mcp --api-key your-key

Point 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:tools

Documentation

• Tatum API documentation
• API reference
• Model Context Protocol
• Repository

License

MIT — see LICENSE.

About Tatum

Tatum provides blockchain APIs, SDKs, and infrastructure for developers.