mcp server

arcade-agent-mcp

obseasd/arcade-agent-mcpcommunitylistedunreviewednot running here yet

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "obseasd-arcade-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "arcade-agent-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

Arcade Agent MCP

Lets any MCP-capable AI agent (Claude Desktop, Claude Code, etc.) use Arcade — a USDC-native DEX + bonding-curve launchpad on Circle's Arc L1.

The agent discovers markets, gets best-execution quotes, and receives ready-to-sign contract-call descriptors. The agent signs them with its own wallet (e.g. a Circle developer-controlled wallet via createContractExecutionTransaction). This server never holds keys.

Configure (Claude Desktop / Claude Code)

Add to your MCP config (no install needed, npx fetches it):

{
  "mcpServers": {
    "arcade": {
      "command": "npx",
      "args": ["-y", "arcade-agent-mcp"],
      "env": { "ARCADE_API_BASE": "https://www.arcade.trading" }
    }
  }
}

ARCADE_API_BASE defaults to https://www.arcade.trading; point it at http://localhost:3000 for local dev.

From source (development): git clone https://github.com/obseasd/arcade-agent-mcp && cd arcade-agent-mcp && npm install, then use "command": "node", "args": ["/absolute/path/to/index.mjs"].

Tools

Tool	What it does
`arcade_markets`	reference tradeable tokens on Arc
`arcade_trending`	launchpad tokens by market cap
`arcade_portfolio`	known-token balances for a wallet
`arcade_quote`	best-execution price quote (read-only)
`arcade_swap`	build approve + swap descriptors to sign
`arcade_launchpad`	build bonding-curve buy/sell or create-token descriptors
`arcade_multiswap`	build a basket-converge swap (aggregator)

How an agent executes a build result

Every build tool returns { ok, executable, calls: [...] } where each call is:

{
  "contractAddress": "0x...",
  "abiFunctionSignature": "swapExactTokensForTokens(uint256,uint256,address[],address,uint256)",
  "abiParameters": ["1000000", "990000", ["0x...","0x..."], "0xAGENT", "1750000000"]
}

Feed each call, in order, to Circle's createContractExecutionTransaction (blockchain ARC-TESTNET, your agent wallet). Run the approve call first, then the action call.

See ../docs/AGENT_API.md for the full architecture and a worked example.