AI & Agents

Monaco MCP Server

The MCP server works in two modes:

Public mode connects without credentials. Use it for docs search, market discovery, orderbooks, candles, and recent trades.
Authenticated mode connects with MONACO_PRIVATE_KEY and MONACO_CLIENT_ID. Use it for account context, vault actions, testnet faucet requests, and order management.

claude mcp add monaco \
  -e MONACO_NETWORK=staging \
  -- npx -y @0xmonaco/mcp-server

claude mcp add monaco \
  -e MONACO_NETWORK=staging \
  -e MONACO_PRIVATE_KEY=0x... \
  -e MONACO_CLIENT_ID=688a21440e304c06b935f743dae88278 \
  -- npx -y @0xmonaco/mcp-server

Run once in your terminal, then start a new Claude Code session.

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

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "staging",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "688a21440e304c06b935f743dae88278"
      }
    }
  }
}

Paste into claude_desktop_config.json, then restart Claude Desktop.

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

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "staging",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "688a21440e304c06b935f743dae88278"
      }
    }
  }
}

Paste into ~/.cursor/mcp.json, then reload Cursor.

code --add-mcp '{"name":"monaco","command":"npx","args":["-y","@0xmonaco/mcp-server"],"env":{"MONACO_NETWORK":"staging"}}'

code --add-mcp '{"name":"monaco","command":"npx","args":["-y","@0xmonaco/mcp-server"],"env":{"MONACO_NETWORK":"staging","MONACO_PRIVATE_KEY":"0x...","MONACO_CLIENT_ID":"688a21440e304c06b935f743dae88278"}}'

Run once in your terminal, then reload the VS Code window.

[mcp_servers.monaco]
command = "npx"
args = ["-y", "@0xmonaco/mcp-server"]

[mcp_servers.monaco.env]
MONACO_NETWORK = "staging"

[mcp_servers.monaco]
command = "npx"
args = ["-y", "@0xmonaco/mcp-server"]

[mcp_servers.monaco.env]
MONACO_NETWORK = "staging"
MONACO_PRIVATE_KEY = "0x..."
MONACO_CLIENT_ID = "688a21440e304c06b935f743dae88278"

Add this to ~/.codex/config.toml, then restart Codex CLI.

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

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "staging",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "688a21440e304c06b935f743dae88278"
      }
    }
  }
}

Paste into ~/.codeium/windsurf/mcp_config.json, then reload Windsurf.

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

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "staging",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "688a21440e304c06b935f743dae88278"
      }
    }
  }
}

Paste into Cline’s MCP Servers settings, then reload Cline.

{
  "context_servers": {
    "monaco": {
      "command": {
        "path": "npx",
        "args": ["-y", "@0xmonaco/mcp-server"],
        "env": {
          "MONACO_NETWORK": "staging"
        }
      }
    }
  }
}

{
  "context_servers": {
    "monaco": {
      "command": {
        "path": "npx",
        "args": ["-y", "@0xmonaco/mcp-server"],
        "env": {
          "MONACO_NETWORK": "staging",
          "MONACO_PRIVATE_KEY": "0x...",
          "MONACO_CLIENT_ID": "688a21440e304c06b935f743dae88278"
        }
      }
    }
  }
}

Paste under context_servers in Zed’s settings.json, then reload Zed.

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

{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "staging",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "688a21440e304c06b935f743dae88278"
      }
    }
  }
}

Paste into any MCP client that accepts a standard mcpServers JSON block.

Use a dedicated staging key for authenticated agent access. Authenticated mode requires MONACO_PRIVATE_KEY, MONACO_CLIENT_ID, and an explicit MONACO_NETWORK: the server refuses to default an authenticated session to mainnet. During private alpha, request a client ID from Monaco; public testnet and mainnet issuance will be documented with those launches.

What you can do

In public read-only mode, your AI can search Monaco docs, list trading pairs, resolve a market by symbol, inspect market metadata, fetch candlesticks, read orderbooks, and review recent trades. This is the right mode for market analysis, documentation lookup, app planning, and learning how Monaco works without connecting a wallet. In authenticated trading mode, your AI can inspect profile and balance context, read movements, simulate fees, place market or limit orders, replace orders, cancel one or many orders, close open positions, approve and move funds through the account vault, check allowances, and request testnet faucet assets. Use this mode when you want an assistant to act through a configured wallet on staging or another selected Monaco network.

For agents & raw access

/llms.txt gives agents a compact docs index.
/llms-full.txt gives agents the full docs bundle.
REST, WebSocket, and gRPC APIs are available for direct integrations.

Learn

Build

Libraries

APIs

Resources

Monaco MCP Server

What you can do

For agents & raw access

​Monaco MCP Server

​What you can do

​For agents & raw access

Monaco MCP Server

What you can do

For agents & raw access