About Multichain Mcp
Multichain Mcp is an MCP server package that gives AI agents access to balances, prices, portfolios, transfers, and token deployment across Stacks, Celo, and Base. Its blockchain operations include unsigned transactions for users to sign with their own wallet.
Key features
- 01Balance and token price lookup
- 02Portfolio aggregation across three chains
- 03Prepare unsigned transfer transactions
- 04Prepare token deployment transactions
- 05Programmatic TypeScript functions
Use cases
- 01Checking wallet balances on Stacks, Celo, or Base
- 02Reviewing holdings across all three chains
- 03Preparing a transfer for wallet signing
- 04Preparing token deployment on Celo or Base
MCP support
The MCP server exposes five tools for balance and price queries, portfolio aggregation, transfer preparation, and token deployment preparation. Write operations return unsigned transactions.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @wkalidev/multichain-mcpMULTICHAIN_LICENSE_KEYSecretOptional Lemon Squeezy license key. Omit to run on the Free tier (get_balance, get_prices). Unlocks get_portfolio and prepare_transfer on Pro, plus deploy_token on Team.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
5Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| chain | enum | Yes | Target blockchaincelo | base | stacks |
| address | string | Yes | Wallet address (EVM 0x... or Stacks SP/ST...) |
Details
From the project README@wkalidev/multichain-mcp
The only MCP server that gives AI agents native access to Stacks, Celo, and Base — from a single npm package.
Connect Claude Desktop, Cursor, or any MCP-compatible AI to 3 blockchains in under 5 minutes.
Why this exists
Building an AI agent that interacts with Web3 today means writing separate integrations for every chain. This package ships a production-ready MCP server with 5 battle-tested tools across Stacks (Bitcoin L2), Celo, and Base — no RPC keys required to start.
Pricing
| Tier | Price | Tools | |
|---|---|---|---|
| Free | $0 | get_balance, get_prices | |
| Pro | $9/mo | + get_portfolio, prepare_transfer | Lemon Squeezy → · GitHub Sponsors → |
| Team | $29/mo | + deploy_token | Lemon Squeezy → · GitHub Sponsors → |
Tools included
| Tool | Description | Tier |
|---|---|---|
get_balance | Native + token balances for any wallet | Free |
get_prices | Live prices + 24h change (STX, CELO, ETH, USDC, WBTC…) | Free |
get_portfolio | Aggregate view across all 3 chains in one call | Pro |
prepare_transfer | Build unsigned tx for native or ERC-20/SIP-010 transfer | Pro |
deploy_token | Prepare unsigned ERC-20 deployment tx on Celo or Base | Team |
All write operations return unsigned transactions — your users always sign with their own wallet. Non-custodial by design.
Install
npm install @wkalidev/multichain-mcp
Claude Desktop setup
Add to your claude_desktop_config.json:
{
"mcpServers": {
"multichain": {
"command": "npx",
"args": ["-y", "@wkalidev/multichain-mcp"],
"env": {
"MULTICHAIN_LICENSE_KEY": "your-license-key"
}
}
}
}
Omit the env block to run on the Free tier. Restart Claude Desktop after adding your key.
Cursor / Windsurf setup
Add to .cursor/mcp.json or .windsurf/mcp.json:
{
"mcpServers": {
"multichain": {
"command": "npx",
"args": ["-y", "@wkalidev/multichain-mcp"],
"env": {
"MULTICHAIN_LICENSE_KEY": "your-license-key"
}
}
}
}
Usage examples
Check Stacks wallet
"What tokens does SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR hold on Stacks?"
→ get_balance({ address: "SP2C2YFP...", chain: "stacks" })
Full multichain portfolio
"Show me my full portfolio across all chains"
→ get_portfolio({ addresses: { stacks: "SP...", celo: "0x...", base: "0x..." } })
Deploy a token
"Deploy a token called GreenDAO with symbol GRN, 1M supply on Base"
→ deploy_token({ chain: "base", name: "GreenDAO", symbol: "GRN", totalSupply: "1000000", ownerAddress: "0x..." })
Live prices
"What are the current prices of STX, CELO and ETH?"
→ get_prices({ symbols: ["STX", "CELO", "ETH"] })
Networks
| Chain | RPC | Explorer |
|---|---|---|
| Stacks | api.hiro.so (public) | explorer.hiro.so |
| Celo | forno.celo.org (public) | celoscan.io |
| Base | mainnet.base.org (public) | basescan.org |
No API keys required for basic usage.
Programmatic use
import { getBalance, getPortfolio, getPrices } from "@wkalidev/multichain-mcp";
const balance = await getBalance({ address: "SP2C2YFP...", chain: "stacks" });
const prices = await getPrices({ symbols: ["STX", "CELO", "ETH"] });
Built by
@wkalidev — author of celobank-agent (ERC-8004 AI agent, 21 MCP tools on Celo mainnet) and stacks-quest (non-custodial DeFi terminal on Stacks Bitcoin L2).
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.