@0xmonaco/mcp-server

MCP server for the Monaco SDK — gives AI assistants access to the Monaco protocol on Sei.

Works in public-only mode with zero configuration. Add a private key to enable authenticated tools — scoped by a capability profile so that supplying a key does not blindly unlock the entire tool set.

Configuration

Capability profiles

MONACO_CAPABILITY bounds which authenticated tools the server registers. A tool that is not permitted by the active profile (and not named in MONACO_TOOL_ALLOWLIST) is never registered — this is an authorization control, not an advisory tool annotation.

Order placement, cancel, replace, and close require MONACO_CAPABILITY=market-maker or higher — the default read profile cannot mutate anything. Fund-movement and privilege tools additionally require full; enable them with MONACO_CAPABILITY=full, or opt a single tool in with MONACO_TOOL_ALLOWLIST (e.g. MONACO_TOOL_ALLOWLIST=vault_withdraw). Grant full only when you intend an agent to move funds — especially on mainnet.

Delegated owner mode

Set MONACO_DELEGATED_OWNER_USER_ID to act on behalf of a delegated owner account instead of the configured wallet's own account. The wallet in MONACO_PRIVATE_KEY is the agent: on startup it authenticates as itself, then adopts an owner-scoped delegated session (loginAsDelegatedOwner). Every subsequent tool call — reads and trades — acts on the owner account, with the agent wallet kept as the session's actor for policy enforcement. Orders placed this way carry the owner's wallet, not the agent's, so order history does not record the agent. The owner must have registered this agent wallet with an active delegation policy; the server cannot self-assert ownership, and adoption fails if the agent is not authorized for that owner.

This is fail-closed: MONACO_DELEGATED_OWNER_USER_ID requires MONACO_PRIVATE_KEY and MONACO_CLIENT_ID, a blank value is rejected, and if owner adoption fails the server does not fall back to trading as the agent's own account. Fund-movement tools still require the full capability, and delegated sessions cannot withdraw owner collateral. Raw delegated-session creation is intentionally not exposed as a tool — owner adoption is a startup option, not an autonomous agent action.

Networks

For public endpoints, set MONACO_NETWORK to mainnet:

Installation

Add the following to your MCP config:

• Cursor — ~/.cursor/mcp.json
• Windsurf — ~/.codeium/windsurf/mcp_config.json
• Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

Public-only mode (no env vars needed)

Market data, orderbook, trades, and docs search — no wallet required.

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"]
    }
  }
}

Authenticated mode

Authenticated read-only tools under the default read profile. MONACO_NETWORK is required here — the server will not default an authenticated session to mainnet.

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "mainnet",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "your-client-id"
      }
    }
  }
}

Trading and fund movement stay off here. Add "MONACO_CAPABILITY": "market-maker" to place / cancel / replace orders, or "MONACO_CAPABILITY": "full" to also enable fund-movement tools (vault deposit/withdraw, transfer_rewards). A single fund-movement tool can be opted in with "MONACO_TOOL_ALLOWLIST": "vault_withdraw" instead of full. RPC URLs default automatically per network but can be overridden with MONACO_RPC_URL.

Tools

Public tools require no credentials. Authenticated tools require MONACO_PRIVATE_KEY, MONACO_CLIENT_ID, and MONACO_NETWORK, and are further gated by the active capability profile — the profile column shows the minimum profile each tool needs.

Search

Market

Perp market data

Orderbook

Trades

Trading

Order reads (get_orders, get_order) are available under read; the mutations below require market-maker or higher.

Positions

Position reads are available under read; close_position requires market-maker, and margin add/reduce move collateral and require full.

Portfolio

Margin accounts

Reads and risk simulations are available under read; collateral transfers move funds and require the full profile (or an explicit allowlist entry).

Profile

Fees

Vault

Fund-movement tools require the full profile (or an explicit allowlist entry); the allowance and pending-withdrawal reads are available under read.

Faucet

Testnet only — the faucet tools are never registered on mainnet.

Trader codes & rewards

Market pulse

This inventory is generated from the tool manifest. Do not edit it by hand — edit src/manifest.ts and run bun run mcp-docs:gen.