About tatumio/blockchain-mcp
tatumio/blockchain-mcp is an MCP server published by tatumio in the Developer Tools category: mCP server to perform blockchain operations using thirdweb.
The repository has 15 stars and 15 forks, with the last commit 4 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/tatumio/blockchain-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
check_malicious_addressSecurity check for a wallet/contract address
Parameters not published.
check_ownerWhether an address owns a given token
Parameters not published.
get_block_by_timeBlock info for a timestamp
Parameters not published.
get_exchange_rateFiat/crypto rate (e.g. `BTC` / `USD`)
Parameters not published.
get_metadataNFT/multitoken metadata by contract address and token IDs
Parameters not published.
get_ownersOwners of an NFT or token contract
Parameters not published.
get_tokensToken metadata (contract address or `native`)
Parameters not published.
get_transaction_historyTransaction history for one or more addresses
Parameters not published.
get_wallet_balance_by_timeNative wallet balance at a block or timestamp
Parameters not published.
get_wallet_portfolioWallet portfolio (native, fungible, NFT)
Parameters not published.
Ask AI
Ask AI about tatumio/blockchain-mcp
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
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_ratewithsymbol: BTC,basePair: USD - “Show Vitalik’s native ETH balance history” →
get_wallet_portfolio/get_transaction_historyonethereum-mainnet - “What is the latest Ethereum block number?” →
gateway_execute_rpcwitheth_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.
README fetched from the repository 7 days ago. The original is authoritative.