multichain-mcp
MCP server for AI agents — Stacks, Celo, and Base in one npm package.
Open source Open in the app JSON README (API)
About
MCP server for AI agents — Stacks, Celo, and Base in one npm package.
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- wkalidev
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.2.1
- Stars
- 1
- Last push
- 2026-08-04T21:31:11Z
- Repository state
- ativo
- Language
- HTML
- Added
- 2026-08-29 04:01:40
- Updated
- 2026-08-29 04:01:40
- Origin id
io.github.wkalidev/multichain-mcp
README
# @wkalidev/multichain-mcp
[](https://glama.ai/mcp/servers/wkalidev/multichain-mcp)
[](https://glama.ai/mcp/servers/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 →](https://wkalidev.com/checkout/buy/74e9f10d-3806-413c-881d-761319ee535b) · [GitHub Sponsors →](https://github.com/sponsors/wkalidev) |
| **Team** | $29/mo | + `deploy_token` | [Lemon Squeezy →](https://wkalidev.com/checkout/buy/00764bb0-5d36-4688-832c-f54b95df791f) · [GitHub Sponsors →](https://github.com/sponsors/wkalidev) |
---
## 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
```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
| 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
```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](https://github.com/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