MMCPMarkets
TB

tatumio/blockchain-mcp

Developer tools
15 stars 15 forks Quality 80 Trend 25MIT
Repository Install

A Model Context Protocol (MCP) server that exposes the Tatum Blockchain Data API and RPC Gateway so LLM clients can query blockchain data across . Get an API key on the Tatum MCP page or dashboard.

Overview

A Model Context Protocol (MCP) server that exposes the Tatum Blockchain Data API and RPC Gateway so LLM clients can query blockchain data across . Get an API key on the Tatum MCP page or dashboard. - : Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Base, Avalanche, and many more. - 🔗 : Blocks, transactions, balances, network info, and more. - 🌐 : Direct access to blockchain RPC endpoints. Published binaries: blockchain-mcp and blockchain-mcp-server (same entrypoint). 1. Create a free API key at dashboard.tatum.io. 2. Add the server to your MCP client (Cursor, Claude Desktop, VS Code, etc.): Do not commit API keys. Use environment variables in client config only. Once connected, you can ask your assistant to use MCP tools, for example: - “What is the BTC/USD exchange rate?

README

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

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

License

MIT — see LICENSE.

About Tatum

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

View the full README on GitHub

Install

npx @tatumio/blockchain-mcp
New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "tatumio": { "command": "npx", "args": ["@tatumio/blockchain-mcp"], "env": { "TATUM_API_KEY": "YOUR_API_KEY" } } } }