multichain-mcp

io.github.wkalidevPublished by GitHub account wkalidevv1.2.1Updated Oct 24, 2026

MCP server for AI agents — Stacks, Celo, and Base in one npm package.

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

A local MCP server that gives an AI assistant read access to Stacks, Celo and Base wallets and prices, plus unsigned transaction preparation on paid tiers.

What you can do
Check native and token balances for a wallet on Stacks, Celo or Base, and fetch live prices with 24h change for assets such as STX, CELO, ETH, USDC and WBTC (free tier). Aggregate a portfolio view across all three chains in one call (Pro). Build unsigned native or ERC-20/SIP-010 transfer transactions (Pro). Prepare an unsigned ERC-20 token deployment transaction on Celo or Base (Team).
When to use it
Useful when an assistant needs to look up multichain wallet balances or token prices, or draft transfer and token-deployment transactions for a user to sign in their own wallet. It suits Web3 workflows spanning Stacks, Celo and Base rather than a single chain.
Requirements
Runs locally via npx, so Node.js is needed. No RPC or API keys are required for basic use; public RPC endpoints are used. A MULTICHAIN_LICENSE_KEY environment variable is optional: omit it for the free tier, or supply a paid license key to unlock portfolio, transfer and deployment tools.
Before you install
Paid tiers cost money (Pro and Team are monthly subscriptions) and are unlocked by the MULTICHAIN_LICENSE_KEY secret, which should be kept private. Write tools only return unsigned transactions, so signing stays with the user's wallet, but the assistant can still draft transfers and token deployments that spend real funds if signed. Wallet addresses and queries are sent to public chain RPC providers.

Installation

In SourceWeft

  1. Open multichain-mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@wkalidev/multichain-mcp

[multichain-mcp MCP server] [multichain-mcp MCP server]

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

TierPriceTools
Free$0get_balance, get_prices
Pro$9/mo+ get_portfolio, prepare_transferLemon Squeezy → · GitHub Sponsors →
Team$29/mo+ deploy_tokenLemon Squeezy → · GitHub Sponsors →

Tools included

ToolDescriptionTier
get_balanceNative + token balances for any walletFree
get_pricesLive prices + 24h change (STX, CELO, ETH, USDC, WBTC…)Free
get_portfolioAggregate view across all 3 chains in one callPro
prepare_transferBuild unsigned tx for native or ERC-20/SIP-010 transferPro
deploy_tokenPrepare unsigned ERC-20 deployment tx on Celo or BaseTeam

All write operations return unsigned transactions — your users always sign with their own wallet. Non-custodial by design.


Install

bash
npm install @wkalidev/multichain-mcp

Claude Desktop setup

Add to your claude_desktop_config.json:

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:

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

ChainRPCExplorer
Stacksapi.hiro.so (public)explorer.hiro.so
Celoforno.celo.org (public)celoscan.io
Basemainnet.base.org (public)basescan.org

No API keys required for basic usage.


Programmatic use

typescript
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

Source: README.md at commit a1efdc0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.2.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.