What blockchain networks does this MCP server support?

It supports 130+ networks including Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Base, and Avalanche, covering both EVM chains (like Ethereum, Polygon, Optimism) and non-EVM chains (like Bitcoin, Solana, Cardano, Ripple).

What are the main tools available in this MCP server?

It provides 13 tools split into two groups: 10 Blockchain Data tools (get_metadata, get_wallet_balance_by_time, get_wallet_portfolio, get_transaction_history, get_exchange_rate, etc.) and 3 RPC Gateway tools (gateway_get_supported_chains, gateway_get_supported_methods, gateway_execute_rpc).

Do I need an API key to use this MCP server?

Yes, a TATUM_API_KEY is required for every tool call, though a free tier is available at dashboard.tatum.io. The API key should only be set via environment variables in client config, never committed to source control.

What are the system requirements to run this MCP server?

It requires Node.js 18+ and is compatible with Cursor, Claude Desktop, and VS Code as MCP clients. It can be run via `npx @tatumio/blockchain-mcp` or installed globally with `npm install -g @tatumio/blockchain-mcp`.

What kind of blockchain data can I query with this server?

You can query wallet balances and portfolios, NFT and token metadata, transaction history, exchange rates between fiat and crypto, check if addresses are malicious, and execute raw JSON-RPC or REST calls directly against blockchain networks.

MCP Connector

Access Blockchain Data Across 130+ Networks

Name: Blockchain MCP Server
Availability: OnlineOnly
Author: Tatum

Query blockchain data (balances, NFTs, transactions, RPC) across 130+ networks via Tatum's Blockchain Data API and RPC Gateway.

Connect

Works with tatum

Tatum

Own this? Claim it

Spark score

out of 100

Updated 2 months ago

Version 1.0.0

Models

universal

Add to Favorites

Why it matters

Integrate LLMs with blockchain data and RPC gateways. This asset enables reading and writing blockchain data across over 130 networks, including EVM and non-EVM chains.

Outcomes

What it gets done

Retrieve NFT/multi-token metadata by address and ID

Get wallet balance at a specific time and transaction history

Execute RPC calls on any supported network

Check for malicious addresses and get exchange rates

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-blockchain-mcp | bash

Capabilities

Tools your agent gets

get_metadata

Retrieve NFT/multi-token metadata by address and ID

get_wallet_balance_by_time

Get wallet balance at a specific time

get_wallet_portfolio

Retrieve complete wallet portfolio

get_owners

Get NFT/token owners

check_owner

Check if an address owns a specific token

get_transaction_history

Get transaction history for an address

get_block_by_time

Get block information by timestamp

get_tokens

Get tokens for a specific wallet

+5 tools

Overview

Blockchain MCP Server

An MCP server powered by Tatum exposing blockchain data (wallets, NFTs, transactions, exchange rates) and RPC access across 130+ networks. Use it when an assistant needs to answer blockchain questions or run RPC calls conversationally - requires a TATUM_API_KEY.

What it does

This MCP server, powered by Tatum, exposes the Tatum Blockchain Data API and RPC Gateway so AI assistants can query blockchain data across 130+ networks including Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Base, and Avalanche. It provides 13 tools split into two groups.

Blockchain Data tools (10): get_metadata (NFT/multitoken metadata), get_wallet_balance_by_time (native balance at a block or timestamp), get_wallet_portfolio (native, fungible, and NFT holdings), get_owners (owners of an NFT or token contract), check_owner (whether an address owns a given token), get_transaction_history, get_block_by_time, get_tokens (token metadata), check_malicious_address (security check for a wallet/contract), and get_exchange_rate (fiat/crypto rate).

RPC Gateway tools (3): gateway_get_supported_chains, gateway_get_supported_methods, and gateway_execute_rpc for running a JSON-RPC or REST call directly against a chain.

npx @tatumio/blockchain-mcp

When to use - and when NOT to

Use this when you want an AI assistant to answer blockchain questions conversationally - checking a wallet's ETH balance history, looking up the BTC/USD exchange rate, finding the latest Ethereum block number, or checking whether an address is flagged as malicious - across any of Tatum's 130+ supported networks. Typical prompts map directly to a tool: "What is the BTC/USD exchange rate?" calls get_exchange_rate with symbol: BTC, basePair: USD; "What is the latest Ethereum block number?" calls gateway_execute_rpc with the eth_blockNumber method.

Do NOT use this without a TATUM_API_KEY (free tier available at dashboard.tatum.io) - it's required for every tool call. Requires Node.js 18+, and API keys should only be set via environment variables in client config, never committed to source control.

Inputs and outputs

Inputs are a chain identifier (Tatum gateway name, e.g. ethereum-mainnet, bitcoin-mainnet), plus addresses, contract IDs, timestamps, or RPC method names; outputs are wallet balances/portfolios, NFT/token metadata, transaction history, exchange rates, or raw RPC/REST responses.

Key tools: get_wallet_portfolio(address, chain), get_transaction_history(address, chain), get_exchange_rate(symbol, basePair), gateway_execute_rpc(chain, method), gateway_get_supported_chains().

Integrations

Tatum's Blockchain Data API and RPC Gateway, covering 130+ EVM and non-EVM chains. EVM chains include Ethereum (mainnet, Sepolia, and Holesky testnets), Polygon, Arbitrum, Optimism, Base, BSC, Avalanche, Fantom, Celo, Gnosis, and Ronin; non-EVM chains include Bitcoin, Litecoin, Dogecoin, Solana, Cardano, Tezos, Stellar, and Ripple. Compatible with Cursor, Claude Desktop, and VS Code as MCP clients.

Who it's for

Web3 developers and crypto researchers who want an AI assistant to query wallet balances, NFT/token data, transaction history, and live RPC endpoints across many blockchains through one unified API. The published npm package ships under two equivalent binary names, blockchain-mcp and blockchain-mcp-server, both pointing at the same entrypoint, and can be run either via a one-time npx @tatumio/blockchain-mcp invocation or a persistent global install with npm install -g @tatumio/blockchain-mcp.

Source 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

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

About Tatum

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

FAQ

Common questions

Discussion