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

hljs language-bash

npm install -g @tatumio/blockchain-mcp

Or use without a global install:

hljs language-bash

npx @tatumio/blockchain-mcp

Published binaries: blockchain-mcp and blockchain-mcp-server (same entrypoint).

MCP client setup

Create a free API key at dashboard.tatum.io.
Add the server to your MCP client (Cursor, Claude Desktop, VS Code, etc.):

hljs language-json

{
  "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

hljs language-bash

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:

hljs language-bash

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:

hljs language-json

{
  "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):

hljs language-bash

npm run verify:tools

blockchain-mcp

Blockchain MCP powered by Tatum

Features

Installation

MCP client setup

Example prompts

Available tools (13)

Blockchain Data (10)

RPC Gateway (3)

Supported networks

Development

Documentation

License

About Tatum

Similar Packages

Security

Original Author

Publisher