@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

Terminal

npm install @wkalidev/multichain-mcp

Claude Desktop setup

Add to your claude_desktop_config.json:

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:

config.json

{
  "mcpServers": {
    "multichain": {
      "command": "npx",
      "args": ["-y", "@wkalidev/multichain-mcp"],
      "env": {
        "MULTICHAIN_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

Usage examples

Check Stacks wallet

Code

"What tokens does SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR hold on Stacks?"
→ get_balance({ address: "SP2C2YFP...", chain: "stacks" })

Full multichain portfolio

Code

"Show me my full portfolio across all chains"
→ get_portfolio({ addresses: { stacks: "SP...", celo: "0x...", base: "0x..." } })

Deploy a token

Code

"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

Code

"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

server.ts

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