tatumio/blockchain-mcp

MCP TypeScript NPM Version License: MIT

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.

Install MCP Server

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.