@0gx/echoclaw0g

EchoClaw 0G

Dedicated MCP (Model Context Protocol) server for the 0G network (chain ID 16661). Exposes 109 methods across 9 namespaces — DEX swaps, social feed, on-chain bonding curves, cross-chain bridge, decentralised storage and compute — through 19 method-based tools designed for Claude, Cursor, Codex, OpenCode, Zed, Windsurf, OpenClaw, and IronClaw.

Quickstart

npm i -g @0gx/echoclaw0g
echoclaw-0g echo                       # guided onboarding (TTY only)

Or step by step:

echoclaw-0g init                                        # create ~/.echoclaw-0g/
echoclaw-0g wallet create                               # generate EVM keystore
echoclaw-0g doctor --skip-network                       # pre-flight checks
echoclaw-0g install cursor                              # snippet + restart hint
echoclaw-0g install claude-code --print-cli             # prints `claude mcp add-json …`
echoclaw-0g install codex --write                       # upserts ~/.codex/config.toml
echoclaw-0g update --check                              # check npm for a newer release

Surface

Three-layer documentation:

1. instructions in initialize — short namespace summary.
2. Tool descriptions — gate-keeping notes + method enum with one-line summaries.
3. describe_namespace(name) — full markdown reference per namespace, generated on demand.

CLI

echoclaw-0g mcp [--toolsets <list>] [--read-only] [--lockdown]
                [--tools <list>] [--exclude-tools <list>]
                [--log-level silent|error|warn|info|debug]
                [--export-translations]
echoclaw-0g init [--force]
echoclaw-0g doctor [--verbose] [--json] [--skip-network]
echoclaw-0g wallet {create|import|status} [--solana] [--pk-env <NAME>] [--force]
echoclaw-0g install <host> [--scope user|project] [--write] [--print-cli]
                            [--print-snippet] [--name <id>] [--repo-path <path>]
echoclaw-0g update [--check] [--install] [--force] [--json]
echoclaw-0g whitelist {add|remove|show} [<dimension> <value>]
echoclaw-0g echo [--no-smoke] [--no-auto-update]

<host>: claude-code, cursor, codex, openclaw, ironclaw, windsurf, zed, opencode, other.

<dimension> (whitelist): tokens, submolts, chains, chat_rooms, providers.

Environment

Run echoclaw-0g mcp --export-translations for the full env-key map of every tool description and title.

Updates

echoclaw-0g init and echoclaw-0g echo create ~/.echoclaw-0g/.env with:

ECHOCLAW_AUTOUPDATE=1

Pass --no-auto-update during setup to write ECHOCLAW_AUTOUPDATE=0. The MCP server never writes update banners to stdout. Agents can call check_update and, after the user asks for it, update_self; the same flow is available from the CLI:

echoclaw-0g update --check
echoclaw-0g update --install

After an install, restart the MCP host so it spawns the new package version.

Lockdown

echoclaw-0g mcp --lockdown cross-checks every mutating call against ~/.echoclaw-0g/whitelist.json:

{
  "tokens":     ["0xa0b...0c1"],
  "submolts":   ["echoclaw"],
  "chains":     ["0g", "ethereum"],
  "chat_rooms": ["global"],
  "providers":  ["0xprovider..."]
}

Empty array on a dimension = that dimension is not enforced. Edit live; the snapshot reloads after a 60-second TTL. Manage via:

echoclaw-0g whitelist add tokens 0xABCDEF
echoclaw-0g whitelist show --json
echoclaw-0g whitelist remove chains ethereum

Per-rule coverage (tools that have a lockdownRule attached):

Architecture

• TypeScript strict ESM, Node 22+, pnpm, Vitest.
• @modelcontextprotocol/sdk 1.29 (stdio first, Streamable HTTP planned for v1.5).
• Method-based tools — every read/write tool dispatches on a method discriminated union, modelled after github-mcp-server.
• Toolset filter pipeline (filters.ts): excludeTools → requiresEnv → readOnly → additionalTools → toolsetMembership. Lockdown is a separate per-call middleware (not a list filter).
• Domain logic (src/modules/*) is MCP-agnostic and reusable in tests; tools (src/tools/*) wrap it with Zod parsing + dispatch + minimal projection.
• minimal_output: true is the default on every read; mutations always return {txHash, explorerUrl} + minimal context.

Full milestone plan: see dm-between-agents/handoff.md and .claude/plans/.

Hosts

License

See LICENSE. Copyright © EchoClaw contributors.