@maroo-chain/mcp

Maroo Chain MCP — read-only chain knowledge + chain access for AI clients. Pairs with @maroo-chain/m-aws (the agent-wallet stack); stands alone as the chain's eyes.

Two MCP servers in one kit:

• @maroo-chain/mcp ← this one. Knowledge base + read-only chain.
• @maroo-chain/m-aws — stateful agent-wallet stack. AA wallets, on-chain policy, transfers.

Install

Wire it into Claude Code, Cursor, Claude Desktop, Windsurf, or Gemini CLI:

claude mcp add maroo -- npx -y @maroo-chain/mcp serve

Or globally:

npm i -g @maroo-chain/mcp
maroo-mcp init       # create ~/.maroo/ scaffolding
maroo-mcp serve      # start the MCP server (stdio)

What you get

12 tools across 3 categories. All are read-only — the only state this MCP touches is the optional ~/.maroo/keystore/ for wallet-create/-import.

Knowledge — 3 tools

The Maroo knowledge base ships in the package as 111 entries across concepts/ (compliance, core, economics, identity, network, developer), apis/ (rpc, contract, sdk), and guides/ (quickstart, integration, advanced).

| Tool | Purpose | |---|---| | maroo_discover | Adaptive overview of every section the KB covers. Call FIRST in any conversation about Maroo. | | maroo_kb_search | Keyword search across the 111 KB entries. | | maroo_kb_lookup | Read a specific entry by id or path. |

Wallet & Chain — 4 tools

Generic chain access via viem against Maroo testnet (chainId 450815).

| Tool | Purpose | |---|---| | maroo_chain_info | Chain status: block height, gas price, RPC, explorer. | | maroo_wallet_create | Generate a new key, encrypt with AES-256-GCM at ~/.maroo/keystore/. | | maroo_wallet_import | Import an existing key, encrypted at rest. | | maroo_balance | OKRW balance + on-chain PCL volume snapshot. |

Compliance & Transaction — 5 tools

Maroo's compliance gates (PCL precompile) + transfer ergonomics.

| Tool | Purpose | |---|---| | maroo_pcl_check | Would this transfer pass the PCL periodic-volume cap? Read-only preview. | | maroo_pcl_limits | Raw { amount, maxAmount, remaining } from the PCL precompile for any address. | | maroo_preflight | Combined check: local policy + PCL + balance. Run before maroo_send. | | maroo_send | Sign + broadcast an OKRW transfer. Auto-runs preflight as a safety net. | | maroo_tx_status | Poll a tx hash for receipt. |

Architecture

• MCP server: stdio transport, @modelcontextprotocol/sdk v1.12+.
• Chain access: viem read-only public client against rpc-testnet.maroo.io. No private keys leave ~/.maroo/keystore/ unless the user signs a transaction with their passphrase.
• PCL precompile: 0x1000000000000000000000000000000000000005, function globalOkrwEasPeriodicVolume(address) → (amount, maxAmount). Verified ABI shared with @maroo-chain/m-aws's tools/globalpolicy-qa/chain-only.ts smoke harness.
• Knowledge base: bundled in the published tarball at <package>/content/. Override with MAROO_KB_PATH to point at a custom KB clone.

Environment

| Var | Default | Purpose | |---|---|---| | MAROO_KB_PATH | bundled content/ | Knowledge base directory. Set for local KB development. | | MAROO_RPC_URL | https://rpc-testnet.maroo.io | RPC endpoint. Set for a private testnet or local node. |

License

MIT. © Hashed Open Finance.