Maroo MCP — @maroo-chain/mcp

component agents

Read-only Maroo knowledge + chain access 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) read-only access to Maroo's knowledge base and chain state. Pair it with @maroo-chain/m-aws when the agent also needs wallet / transfer capability, or run it standalone when the agent only 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 i -g @maroo-chain/mcp
maroo-mcp init       # create ~/.maroo/ scaffolding
maroo-mcp serve      # start the MCP server (stdio)

What it exposes — 12 tools across 3 categories

All tools are read-only. The only persisted state is the optional ~/.maroo/keystore/ for AES-256-GCM-encrypted local keys.

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, encrypted at rest.
maroo_wallet_import — import an existing key, encrypted at rest.
maroo_balance — OKRW balance + on-chain PCL volume snapshot.

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

maroo_pcl_check — read-only preview: would this transfer pass the PCL periodic-volume cap?
(and four more for transaction prep / decoding)

When to use which

Two MCP servers, one decision:

@maroo-chain/mcp (this package) — the chain's eyes. KB knowledge + read-only chain access. 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. Pair with this MCP when your agent needs to actually move OKRW. 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