Tatum MCP Server

Tatum MCP Server

Provides access to Tatum's blockchain API across 40+ networks, enabling developers to interact with blockchain data, manage notifications, estimate fees, access RPC nodes, and work with smart contracts through natural language.

Category
Visit Server

Tools

get_collections_v4

[blockchain_data] /v4/data/collections 20 credits per API call > 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/collections. Users can refer to GET /v4/data/collections for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Get all NFTs (ERC-721 and ERC-1155) and multitokens (ERC-1155 only) of your favorite collections! Our API lets you search for all tokens on: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of collection addresses. Our API will return relevant information about each token, including its name, description, image, and more. Aside from relevant information about each token, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns results for all supported types of tokens (nft, multitokens), but you can also choose to filter only one tokenType. For Tezos blockchain query parameters excludeMetadata and tokenType won't have any effect on filtering data.

get_metadata_v4

[blockchain_data] /v4/data/metadata 10 credits per API call > 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/metadata. Users can refer to GET /v4/data/metadata for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Get metadata of NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) by IDs for a given token address! Our API lets you search for all tokens on: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet To get started: Provide a chain name, token address and comma-separated list of IDs. Our API will return relevant metadata about each specified token, including its name, description, image, and more. Aside from the metadata information, the response also contains token types and metadata url minted in each token.

get_wallet_balance_by_time_v4

[blockchain_data] /v4/data/wallet/balance/time 100 credits per API call Get native balances for a specific wallet addresses by time on the following blockchains: Ethereum - ethereum-mainnet Bitcoin - bitcoin-mainnet Base - base-mainnet Arbitrum - arb-one-mainnet BSC - bsc-mainnet Polygon - polygon-mainnet Optimism - optimism-mainnet Celo - celo-mainnet To get started, provide a chain name, comma-separated list of addresses and specify one of the filters listed below (combination of the filters is not allowed): block number time unix If you pass a block number that is in the future (beyond the current latest block), the system will return the balance for the latest block. If you pass a time or Unix timestamp that is in the future, the system will also return the balance for the latest block. If you pass a time or Unix timestamp in the past (dating back to or earlier than the blockchain's genesis block), the system will return the balance for the first block (genesis block).

get_wallet_balances_v4

[blockchain_data] /v4/data/wallet/balances 50 credits per API call This endpoint is deprecated. > 📘 **Note:** > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/wallet/portfolio. As a result, the older endpoint - GET /v4/data/wallet/balances - has been deprecated. These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible. Get balances of native, fungible tokens (ERC-20), NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of addresses. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns balances for all supported types of tokens (native, fungible tokens, nft, multitokens), but you can also choose to filter specific tokenTypes. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata.

get_wallet_portfolio_v4

[blockchain_data] /v4/data/wallet/portfolio 50 credits per API call Get portfolio balances of native, fungible tokens (ERC-20) or NFTs (ERC-721 and ERC-1155) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Solana - solana-mainnet / solana-devnet Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and and an address of that chain. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). The API requires specifying the tokenTypes parameter to indicate which types of tokens to fetch balances for. Supported values include [native], [fungible] and [nft,multitoken]. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata.

get_balances_v4

[blockchain_data] /v4/data/balances 50 credits per API call This endpoint is deprecated. > 📘 **Note:** > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/wallet/portfolio. As a result, the older endpoints - GET /v3/data/balances & GET /v4/data/balances - have been deprecated. These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible. Get balances of fungible tokens (ERC-20), NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of addresses. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns balances for all supported types of tokens (fungible tokens, nft, multitokens), but you can also choose to filter specific tokenTypes. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata.

get_owners_v4

[blockchain_data] /v4/data/owners 50 credits per API call > 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/owners. Users can refer to GET /v4/data/owners for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Get all addresses that own your favorite token (ERC-20, ERC-721 or ERC-1155)! Our API lets you search for all token owners on: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet To get started: Provide a chain name and address of any fungible token, NFT or multitoken collection. Our API will return a list of addresses of all of their owners. You can also get an owner of a specific NFT by specifying tokenId. In case of multitoken, result is an array of addresses.

check_owner_v4

[blockchain_data] /v4/data/owners/address 50 credit per API call > 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/owners/address. Users can refer to GET /v4/data/owners/address for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Check if wallet address owns any specified token (ERC-20, ERC-721 or ERC-1155) on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet To get started: Provide a chain name, wallet address and address of any fungible token, NFT or multitoken collection. Our API will return true if provided wallet address owns them. If wallet address does not own the specific token, response body is false and status code is 200. It is also possible to check if wallet address owns a specific NFT by specifying a tokenId.

get_nft_balances_v4

[blockchain_data] /v4/data/nft/balances 50 credits per API call Get all NFTs that a blockchain address holds. The NFTs are returned grouped by the smart contracts they were minted on. This API is supported for the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Solana - solana-mainnet / solana-devnet Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Algorand - algorand-mainnet-algod / algorand-testnet-algod On Solana and Algorand, if a blockchain address holds fewer than 50 NFTs, the API also returns each NFT's metadata. If the metadata is not returned, you can obtain it using the API for getting NFT metadata.

get_multi_token_balance_v4

[blockchain_data] /v4/data/multitoken/balances 50 credits per API call Get Multi Token balances of a wallet address. The Multi Tokens are returned grouped by the smart contracts they were minted on. This API is supported for the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Algorand - algorand-mainnet-algod / algorand-testnet-algod

estimate_gas

[fee_estimation] 10 credits per API call Get an estimated gas price (wei) and the number of gas units needed for a transaction. New endpoint which is unifying all supported chains for gas estimation into the one. List of supported chains is bellow. BNB Smart Chain (BSC) Celo (CELO) Elrond (EGLD) Ethereum (ETH) Harmony (ONE) Klaytn (KLAY) KuCoin Community Chain (KCS) Flare (FLR) Cronos (CRO) Avalanche (AVAX) Base (BASE) Polygon (POL_ETH) Optimism (OPTIMISM) Fantom (FTM) Sonic (S)

get_blockchain_fee

[fee_estimation] 1 credit per API call Get the recommended fee/gas price for a blockchain. Fee is in satoshis(meaning currency(BTC, DOGE,... / 100 000 000) per byte This API is supported for the following blockchains: Bitcoin Dogecoin Ethereum Litecoin

estimate_fee_blockchain

[fee_estimation] 10 credits per API call Estimate the current fee for different types of transactions. This API is supported for the following blockchains: Bitcoin BNB Smart Chain Celo Dogecoin Ethereum Harmony Klaytn Litecoin Polygon XinFin

bsc_estimate_gas

[fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a BNB Smart Chain transaction. The gas price is obtained from https://explorer.bitquery.io/bsc/gas. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction.

celo_estimate_gas

[fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a Celo transaction. The gas price is obtained from https://explorer.bitquery.io/celo_rc1/gas. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction.

egld_estimate_gas

[fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for an Elrond transaction. The gas price is obtained from https://gateway.elrond.com/network/config. The gas limit is obtains from https://gateway.elrond.com/transaction/cost.

eth_estimate_gas

[fee_estimation] 10 credits per API call Get an estimated gas price and the number of gas units needed for an Ethereum transaction. The gas price is obtained from multiple sources and calculated based on the latest N blocks and the current mempool state. The fast gas price is used by default. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction.

eth_estimate_gas_batch

[fee_estimation] 10 credits per API call + 10 credits per each gas estimation Get an estimated gas price and the number of gas units needed for multiple Ethereum transactions. The gas price is obtained from multiple sources and calculated based on the latest N blocks and the current mempool state. The estimations are returned in the same order as the transactions were submitted in the request. The fast gas price is used by default. NOTE: The estimated gas price is returned in wei. However, when making a transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction.

one_estimate_gas

[fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a Harmony transaction. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction.

klaytn_estimate_gas

[fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a Klaytn transaction. The gas price is obtained from https://explorer.bitquery.io/klaytn/gas. NOTE: The estimated gas price is returned in peb. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gpeb. Make sure to convert the estimated gas price from peb to Gpeb before submitting your transaction.

gateway_get_evm_chains

[gateway] Get a list of all supported EVM-compatible chains

gateway_get_url

[gateway] Get the gateway URL for a specific chain

gateway_is_evm_chain

[gateway] Check if a chain is EVM-compatible

gateway_get_supported_chains

[gateway] Get a list of all supported blockchain chains

gateway_execute_rpc

[gateway] Execute an RPC call on a specific chain

get_available_tools

[gateway] Get a list of all available tools and their capabilities

README

Blockchain MCP

npm version License: MIT

A Model Context Protocol (MCP) server providing access to Tatum's comprehensive blockchain API across 130+ networks with 13 tools including the gateways (access to rpc) & data insights api

🚀 Features

  • 130+ Blockchain Networks: Bitcoin, Ethereum, Polygon, Arbitrum, Base, Avalanche, and many more
  • 13 Tools: Comprehensive blockchain operations
  • 2 Feature Categories:
    • 🔗 Blockchain Data: Blocks, transactions, balances, network info
    • RPC Gateways: Direct access to blockchain RPC endpoints
  • TypeScript: Full type safety and IntelliSense support
  • ES Modules: Modern JavaScript module system

📦 Installation

Global Installation (Recommended)

npm install -g tatum-mcp-server

Local Installation

npm install tatum-mcp-server

🔑 Getting Started

1. Get Your API Key

Get your free API key from Tatum Dashboard.

2. MCP Client Integration

Add this server to your MCP client configuration:

Basic Configuration

{
  "mcpServers": {
    "tatum": {
      "command": "npx",
      "args": [
        "tatum-mcp-server"
      ],
      "env": {
        "TATUM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

With Custom RPC URLs (Bring Your Own RPC)

You can override Tatum's gateway URLs with your own RPC endpoints:

{
  "mcpServers": {
    "tatum": {
      "command": "npx",
      "args": [
        "tatum-mcp-server"
      ],
      "env": {
        "TATUM_API_KEY": "YOUR_API_KEY",
        "BYO_RPC_CONFIG": "{\"ethereum-mainnet\": \"https://ethereum-rpc.publicnode.com\", \"polygon-mainnet\": \"https://polygon-rpc.com\"}"
      }
    }
  }
}

Benefits of Custom RPC URLs:

  • Use your preferred RPC providers
  • No authentication required for your custom endpoints
  • Potentially better performance or reliability
  • Support for private or enterprise RPC endpoints

🛠️ Available Tools

Blockchain Data (10 tools)

  • Get wallet balances and portfolios
  • Query transaction history
  • Retrieve block information
  • Access NFT and token metadata
  • Check token ownership
  • Fetch Real Time Exchange Rates
  • Check Malicious Address

RPC Gateways (3 tools)

  • Execute RPC calls on any supported chain
  • Get supported blockchain networks
  • Direct gateway URL access

🌐 Supported Networks

EVM-Compatible (69 networks)

  • Ethereum: Mainnet, Sepolia, Holesky
  • Layer 2: Polygon, Arbitrum, Optimism, Base
  • Sidechains: BSC, Avalanche, Fantom
  • Enterprise: Celo, Palm, Gnosis
  • Gaming: Ronin, Chiliz
  • And many more...

Non-EVM (61 networks)

  • Bitcoin: Mainnet, Testnet, Signet
  • Alternative Coins: Litecoin, Dogecoin, Bitcoin Cash
  • Smart Contract Platforms: Solana, Cardano, Tezos
  • Enterprise: Stellar, Ripple, EOS
  • And many more...

🔧 Configuration

BYO_RPC_CONFIG Format

The BYO_RPC_CONFIG environment variable uses a simple comma-separated format:

export BYO_RPC_CONFIG="ethereum-mainnet,https://eth.llamarpc.com;polygon-mainnet,https://polygon.llamarpc.com"

For a single chain:

export BYO_RPC_CONFIG="ethereum-mainnet,https://eth.llamarpc.com"

Format: chain1,url1;chain2,url2;chain3,url3

  • Use commas (,) to separate chain name from URL
  • Use semicolons (;) to separate multiple chain configurations
  • No spaces around separators (they will be trimmed automatically)

Supported Chain Names:

  • Use the same chain identifiers as Tatum (e.g., ethereum-mainnet, polygon-mainnet, bsc-mainnet)
  • Custom RPC URLs will override Tatum's gateway URLs for those specific chains
  • Authentication headers are not sent to custom RPC endpoints

📖 Documentation

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

🏢 About Tatum

Tatum is a blockchain development platform that provides APIs, SDKs, and tools for building blockchain applications. Learn more at tatum.io.


Made with ❤️ by the Tatum team

License

MIT

Support

For issues and questions:

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured