Описание

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

Create a free API key at dashboard.tatum.io.
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.

Теги

Cloud