
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.
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
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
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
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.
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.

VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.

E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.