1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Myth Add the cUSD contract on Celo mainnet as cusd" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Myth

npm license

Myth auto-generates Model Context Protocol (MCP) servers for Celo smart contracts. Give it a verified contract address and it fetches the ABI from Blockscout, maps every function and event to an MCP tool, and launches a server your AI agent can call.

Built for Celo's agent-friendly properties: sub-cent gas, fast finality, and stablecoin gas payment via feeCurrency.

Open source under MIT. Contributions welcome — see CONTRIBUTING.md.

Architecture

[Contract Address] → [Blockscout ABI] → [ABI → Zod/JSON Schema] → [MCP Server]
         ↓
 [EIP-1967 Proxy Resolver] → implementation ABI

Step	Module	What it does
1	`blockscout.ts`	`GET ?module=contract&action=getabi&address={addr}`
2	`abi-to-zod.ts`	Maps Solidity types → Zod validators + JSON Schema
3	`abi-events.ts`	Generates `query event` tools from ABI events
4	`celo-tx.ts`	Attaches `feeCurrency` on write txs (pay gas in cUSD/USDT)
5	`create-server.ts`	Wires tools into `@modelcontextprotocol/sdk`
6	`registry.ts`	Multi-contract registry at `~/.myth/registry.json`

Related MCP server: Swagger MCP

Install

# Global CLI
npm install -g @gideondern/myth-celo-mcp

# Or run without installing
npx -y --package @gideondern/myth-celo-mcp myth --help

npm: https://www.npmjs.com/package/@gideondern/myth-celo-mcp

Quick Start

# Infra workflow: add → list → serve
myth add -a 0x765DE816845861e75A25fCA122bb6898B8B1282a -n celo-mainnet --alias cusd
myth list
myth serve   # serves registry (uses ~/.myth/cache for fast restarts)

# Single contract without registry
myth serve -a 0x765DE816845861e75A25fCA122bb6898B8B1282a -n celo-mainnet

# HTTP transport (for remote agents)
myth serve -a 0x765DE816845861e75A25fCA122bb6898B8B1282a -n celo-mainnet --http --port 3100

# Generate a standalone package with manifest + Cursor config
myth generate -a 0x765DE816845861e75A25fCA122bb6898B8B1282a -n celo-mainnet -o ./generated/cusd

Registry & ABI cache

Contracts live in ~/.myth/registry.json. ABIs are cached in ~/.myth/cache/<network>/ (24h TTL).

myth add -a 0x765DE816845861e75A25fCA122bb6898B8B1282a -n celo-mainnet --alias cusd
myth list
myth sync cusd --force   # refresh ABI from Blockscout
myth remove cusd
myth serve               # all registry contracts (cache-first)
myth serve --http        # HTTP transport

Tools are prefixed by alias: cusd_balanceOf, cusd_event_Transfer, etc.

Cursor Integration

Add to ~/.cursor/mcp.json (already configured if you used the setup step):

{
  "mcpServers": {
    "myth-cusd": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@gideondern/myth-celo-mcp",
        "myth",
        "serve",
        "-a",
        "0x765DE816845861e75A25fCA122bb6898B8B1282a",
        "-n",
        "celo-mainnet"
      ],
      "env": {
        "MYTH_FEE_CURRENCY": "cUSD"
      }
    }
  }
}

Serve every contract in your registry (~/.myth/registry.json):

{
  "mcpServers": {
    "myth-registry": {
      "command": "npx",
      "args": ["-y", "--package", "@gideondern/myth-celo-mcp", "myth", "serve", "--registry"]
    }
  }
}

Reload Cursor MCP after saving. For write tools, add MYTH_PRIVATE_KEY to env.

Built-in Meta Tools

Every server includes:

Tool	Description
`myth_contract_info`	Contract addresses, networks, tool counts
`myth_fee_currencies`	Available stablecoins per network for gas

Networks

Network	Blockscout API	Default RPC
`celo-mainnet`	https://celo.blockscout.com/api	https://forno.celo.org
`celo-sepolia`	https://celo-sepolia.blockscout.com/api	https://forno.celo-sepolia.celo-testnet.org

Environment Variables

Variable	Description
`MYTH_CONTRACT_ADDRESS`	Target contract
`MYTH_NETWORK`	`celo-mainnet` or `celo-sepolia`
`MYTH_RPC_URL`	Override RPC endpoint
`MYTH_PRIVATE_KEY`	Wallet for write transactions
`MYTH_FEE_CURRENCY`	Stablecoin for gas (`cUSD`, `USDT`, or `0x...`)
`MYTH_REGISTRY_PATH`	Registry file (default: `~/.myth/registry.json`)
`MYTH_BLOCKSCOUT_API_KEY`	Optional Blockscout PRO API key

Programmatic API

import {
  fetchContractAbi,
  abiToMcpTools,
  launchMythServer,
  launchHttpServer,
  addToRegistry,
} from "@gideondern/myth-celo-mcp";

await launchMythServer({
  contractAddress: "0x765DE816845861e75A25fCA122bb6898B8B1282a",
  network: "celo-mainnet",
  feeCurrency: "cUSD",
});

await launchHttpServer({
  config: { contractAddress: "0x...", network: "celo-mainnet" },
  port: 3100,
});

Development

git clone https://github.com/gideondern/myth-celo-mcp.git
cd myth-celo-mcp
npm install
npm run build
node dist/cli.js add -a 0x765DE816845861e75A25fCA122bb6898B8B1282a -n celo-mainnet --alias cusd
node dist/cli.js serve

References

celo-mcp — Official Celo MCP server (Python)
evm-mcp-server — Dynamic EVM tool patterns
Blockscout Contract API

Myth

Myth

Architecture

Install

Quick Start

Registry & ABI cache

Cursor Integration

Built-in Meta Tools

Networks

Environment Variables

Programmatic API

Development

References

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API