Tatum MCP Server

A Model Context Protocol (MCP) server providing access to Tatum's comprehensive blockchain API across 130+ networks with 59 tools spanning 7 feature categories.

🚀 Features

130+ Blockchain Networks: Bitcoin, Ethereum, Polygon, Arbitrum, Base, Avalanche, and many more
59 Tools: Comprehensive blockchain operations across 7 categories
7 Feature Categories:
- 🔗 Blockchain Data: Blocks, transactions, balances, network info
- 🔔 Notifications: Webhook subscriptions for blockchain events
- 💰 Fee Estimation: Transaction fees and gas costs
- 📜 Smart Contracts: Deploy and interact with ERC20, ERC721, ERC1155
- 🔐 Security & KMS: Key management and secure signing
- 💾 Storage & IPFS: Decentralized storage solutions
- 🏦 Virtual Accounts: Ledger accounts and transactions
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. Run the Server

Using CLI (Global Installation)

# Using command line option
tatum-mcp --api-key YOUR_API_KEY

# Using environment variable
export TATUM_API_KEY=YOUR_API_KEY
tatum-mcp

# Custom port
tatum-mcp --api-key YOUR_API_KEY --port 8080

Using Node.js (Local Installation)

# Set environment variable
export TATUM_API_KEY=YOUR_API_KEY

# Run the server
npx tatum-mcp-server

Using Environment File

Create a .env file:

TATUM_API_KEY=your_api_key_here
PORT=3000

Then run:

tatum-mcp

MCP Client Integration

Add this server to your MCP client configuration:

{
  "mcpServers": {
    "tatum": {
      "command": "node",
      "args": [
        "FullPathTo/TatumMCP/dist/index.js"
      ],
      "env": {
        "TATUM_API_KEY": "Get a free key at : https://dashboard.tatum.io"
      }
    }
  }
}

🛠️ Available Tools

Blockchain Data (20 tools)

Get wallet balances and portfolios
Query transaction history
Retrieve block information
Access NFT and token metadata
Check token ownership

RPC Gateways (5 tools)

Execute RPC calls on any supported chain
Get supported blockchain networks
Access EVM-compatible chains
Direct gateway URL access

Notifications (12 tools)

Create webhook subscriptions
Monitor wallet activities
Track smart contract events
Manage notification settings

Fee Estimation (4 tools)

Estimate transaction fees
Get current gas prices
Calculate optimal fees
Cross-chain fee comparison

Smart Contracts (10 tools)

Deploy ERC20 tokens
Create NFT collections (ERC721)
Manage multi-token contracts (ERC1155)
Interact with existing contracts

Security & KMS (5 tools)

Secure key management
Transaction signing
Wallet generation
Key derivation

Storage & IPFS (3 tools)

Upload files to IPFS
Pin content
Retrieve metadata

🌐 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

Environment Variables

Variable	Description	Default
`TATUM_API_KEY`	Your Tatum API key (required)	-
`PORT`	Server port	3000
`NODE_ENV`	Environment mode	development

CLI Options

tatum-mcp --help

Options:
  --api-key <key>     Set Tatum API key
  --port <port>       Set server port (default: 3000)
  --help, -h          Show help message
  --version, -v       Show version

🎛️ Feature Selection

This project uses a pre-built feature system where enabled features are stored in the generated-features/ directory. The server automatically loads only the features that are included in this directory.

Current Build Configuration

The current build includes the following features:

✅ Blockchain Data - Core blockchain operations, balances, transactions
✅ Fee Estimation - Transaction fee and gas cost estimation
✅ RPC Gateways - Direct access to Tatum's RPC gateways for 130+ blockchain networks

How It Works

Pre-built Features: The generated-features/ directory contains JSON files for each enabled feature
Automatic Loading: The server reads the index.json file to determine which features are available
No Configuration Needed: Users can build and run the project without any additional setup

For Administrators: Custom Feature Builds

If you need to create custom feature combinations, you can use the admin tools:

Edit the configuration (admin only):
// features.config.js (not included in user builds) const ENABLED_FEATURES = { blockchain_data: true, // ✅ Enabled notifications: false, // ❌ Disabled fee_estimation: true, // ✅ Enabled // ... other features };
Generate new features (admin only):
node build.js # Requires core-api directory
The generated features are then committed to the repository for users

Feature Descriptions

Feature	Description	Tools	Priority
`blockchain_data`	Core blockchain operations, balances, transactions	10	High
`gateway`	RPC gateway access to blockchain networks	5	High
`fee_estimation`	Transaction fee and gas cost estimation	4	Medium
`notifications`	Webhook subscriptions and event monitoring	12	Medium
`smart_contracts`	Smart contract deployment and interaction	10	Medium
`security`	Key management and secure transaction signing	5	Low
`storage`	IPFS and decentralized storage solutions	3	Low
`virtual_accounts`	Virtual ledger and account management	11	Low

Benefits of Feature Selection

Reduced Bundle Size: Only include features you actually use
Faster Startup: Fewer features mean faster initialization
Cleaner API: Less clutter in your tool list
Better Performance: Reduced memory footprint
Custom Builds: Create specialized builds for specific use cases

Example Configurations

Minimal Build (Data + Gateway only)

const ENABLED_FEATURES = {
  blockchain_data: true,
  notifications: false,
  fee_estimation: false,
  smart_contracts: false,
  security: false,
  storage: false,
  virtual_accounts: false,
  gateway: true
};

DeFi Build (Data + Contracts + Fees)

const ENABLED_FEATURES = {
  blockchain_data: true,
  notifications: false,
  fee_estimation: true,
  smart_contracts: true,
  security: false,
  storage: false,
  virtual_accounts: false,
  gateway: true
};

Full Build (All features)

const ENABLED_FEATURES = {
  blockchain_data: true,
  notifications: true,
  fee_estimation: true,
  smart_contracts: true,
  security: true,
  storage: true,
  virtual_accounts: true,
  gateway: true
};

📚 Usage Examples

Get Wallet Balance

// Using the MCP client
const result = await client.callTool({
  name: "get_wallet_portfolio_v4",
  arguments: {
    chain: "ethereum-mainnet",
    addresses: "0x...",
    tokenTypes: "native"
  }
});

Execute RPC Call

// Get latest block on Ethereum
const result = await client.callTool({
  name: "gateway_execute_rpc",
  arguments: {
    chain: "ethereum-mainnet",
    method: "eth_getBlockByNumber",
    params: ["latest", false]
  }
});

Get NFT Metadata

// Get NFT metadata
const result = await client.callTool({
  name: "get_metadata_v4",
  arguments: {
    chain: "ethereum-mainnet",
    tokenAddress: "0x...",
    tokenIds: "1,2,3"
  }
});

🏗️ Development

Prerequisites

Node.js 18+
npm or yarn
TypeScript

Setup

# Clone the repository
git clone https://github.com/tatumio/tatum-mcp-server.git
cd tatum-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

Testing

# Run tests
npm test

# Run interactive tests
npm run test:interactive

📖 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:

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

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.

Related MCP Servers

MCP Etherscan Server
crazyrabbitLTC
A
security
A
license
A
quality
Facilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.
Last updated -
6
3
13
TypeScript
MIT License
Adamik MCP Serverofficial
AdamikHQ
A
security
A
license
A
quality
Enables read and write interactions with 60+ blockchain networks through Claude Desktop, providing a standardized multi-chain API for transaction management, account insights, staking, and token interactions.
Last updated -
11
20
2
TypeScript
MIT License
Ethereum RPC MCP Server
0xKoda
A
security
A
license
A
quality
Provides tools for AI assistants to interact with the Ethereum blockchain through standard JSON-RPC methods, enabling queries for account balances, gas prices, and smart contract code.
Last updated -
6
3
JavaScript
MIT License
Nodit MCP Serverofficial
noditlabs
A
security
A
license
A
quality
Connects AI agents and developers to structured blockchain data across multiple networks through Nodit's Web3 infrastructure, enabling easy querying, analysis and interaction with blockchain ecosystems without specialized development expertise.
Last updated -
8
100
11
TypeScript
Apache 2.0

View all related MCP servers