Maroo MCP — @maroo-chain/mcp

component agents

Maroo knowledge, chain reads and a local-key testnet wallet for AI clients via the Model Context Protocol. The lightest integration path for any AI agent that needs to talk to Maroo.

@maroo-chain/mcp is the official Maroo MCP server — an npx-installable Model Context Protocol kit that gives any compatible AI client (Claude Code, Cursor, Claude Desktop, Windsurf, Gemini CLI) Maroo's knowledge base, chain and PCL reads, and a local-key testnet wallet. It is not read-only: its wallet tools create or import a private key and sign and broadcast testnet OKRW transfers with it. Pair it with @maroo-chain/m-aws when the agent needs WaaS-managed AA wallets under on-chain policy, or run it standalone when the agent mainly needs to understand Maroo.

Install (one line per AI client)

# Claude Code
claude mcp add maroo -- npx -y @maroo-chain/mcp serve

# Or install globally and run yourself:
npm install -g @maroo-chain/mcp
maroo-mcp init       # create ~/.maroo/keystore and register `maroo` with your MCP clients (asks per client)
maroo-mcp serve      # start the MCP server (stdio)

What it exposes — 12 tools across 3 categories

Three of the tools are not read-only. maroo_wallet_create and maroo_wallet_import write an AES-256-GCM-encrypted key under ~/.maroo/keystore/, and maroo_send signs a testnet OKRW transfer with that key, broadcasts it and records the amount in ~/.maroo/daily-spending.json for the local spending limits. These three tools take the private key (maroo_wallet_import) and the passphrase as tool arguments, so the model provider sees them and the MCP client keeps them in the conversation transcript: use only a disposable testnet key. The other nine tools only read.

Knowledge (3) — for the AI to actually understand Maroo before doing anything:

maroo_discover — adaptive overview of every KB section. Call this FIRST in any Maroo conversation.
maroo_kb_search — keyword search across all KB entries.
maroo_kb_lookup — read a specific entry by id or path.

Wallet & Chain (4) — generic chain access via viem against Maroo Testnet (chainId 450815):

maroo_chain_info — chain status (block height, gas price, RPC, explorer).
maroo_wallet_create — generate a new key and save it encrypted under ~/.maroo/keystore/.
maroo_wallet_import — import an existing key, encrypted at rest.
maroo_balance — OKRW balance + on-chain PCL daily-volume snapshot.

Compliance & Transaction (5) — Maroo's compliance gates (PCL precompile) + transfers:

maroo_pcl_check — read-only preview: would PCL's global policy accept this transfer (per-transfer cap, daily volume, KYC exemption)?
maroo_pcl_limits — the daily window and per-transfer cap that bind an address, and its KYC status.
maroo_preflight — combined check (local policy + PCL + balance) to run before maroo_send.
maroo_send — runs preflight, then signs and broadcasts a testnet OKRW transfer.
maroo_tx_status — look up a transaction's receipt by hash.

When to use which

Two MCP servers, one decision:

@maroo-chain/mcp (this package) — the chain's eyes, plus a local-key testnet wallet. KB knowledge, chain and PCL reads, and testnet OKRW transfers signed with a key the agent creates or imports. Stands alone. Great default for any AI agent that wants to reason about Maroo.
@maroo-chain/m-aws — the stateful agent-wallet stack. AA wallets, on-chain policy, transfers; WaaS signs for agents, so its tools take no private key or passphrase. Pair with this MCP when your agent needs to move OKRW from a managed agent wallet under policy. See concepts/agents/maws-architecture-overview for the wallet-stack deep dive.

Both ship as separate npm packages. Wire whichever (or both) into your AI client.

Install (one line per AI client)

What it exposes — 12 tools across 3 categories

When to use which

Links

Related Concepts