Skip to main content
Glama
Sign In
Arcade Agent MCP

Arcade Agent MCP

by obseasd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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"].

Related MCP server: arc-market-mcp

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.

Available Tools

8 tools
arcade_launchpadA

Build bonding-curve buy/sell or create-token descriptors on Arc. action='buy' {token, amountUsdcIn}; action='sell' {token, tokensIn}; action='create' {name, symbol, metadataURI?, mode?}. amountUsdcIn/tokensIn are RAW units (USDC 6 decimals, launch tokens 18). Run the returned calls[] in order (approve, then action). token must be a 0x address (launchpad tokens are not symbol-addressable).

Inputs: action (required), mode, name, token, +5 more.

arcade_marketsA

List always-tradeable reference tokens on Arc (USDC, stablecoins, BTC, ETH).

Inputs: no named parameters.

arcade_multiswapA

Build a basket-converge swap (Arcade aggregator): many input tokens into one output token in a single settlement on Arc. inputs amounts are RAW token units. tokenOut accepts a symbol or 0x address. Run the returned calls[] in order (one approve per input, then swapToSingle).

Inputs: inputs (required), tokenOut (required), minTotalOut.

arcade_portfolioB

Get known-token balances for a wallet address.

Inputs: wallet (required).

arcade_quoteA

Best-execution price quote across all Arc venues. Read-only. amountIn is in raw token units.

Inputs: tokenIn (required), amountIn (required), tokenOut (required), slippageBps.

arcade_swapA

Build approve + swap contract-call descriptors (contractAddress, abiFunctionSignature, abiParameters) for the agent to sign with its own wallet on ARC-TESTNET (chainId 5042002). recipient is the agent wallet; output is sent there. amountIn is RAW token units (integer string; USDC has 6 decimals). Run the returned calls[] in order (approve, then swap). tokenIn/tokenOut accept a known symbol (USDC, USDT, EURC, WUSDC, cirBTC, WETH) or a 0x address.

Inputs: tokenIn (required), amountIn (required), tokenOut (required), recipient (required), +1 more.

arcade_swap_finalizeB

Permit2 step 2: after signing the typedData from arcade_swap (Circle sign/typedData), inject the signature and get the execute() call. Pass the same swap params plus the echoed permit and the signature.

Inputs: tokenIn (required), amountIn (required), tokenOut (required), recipient (required), +3 more.

arcade_trendingC

List launchpad tokens ranked by market cap (USDC), with curve progress.

Inputs: limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool serves a clearly distinct purpose: launchpad create/trade, markets listing, multiswap, portfolio balances, quoting, single swap, swap finalization, and trending. No two tools overlap; even swap and swap_finalize are sequential steps with different roles.

    Naming Consistency5/5

    All tools follow the 'arcade_<noun>' pattern using snake_case. Names are descriptive and consistent, with variations only in compound words (multiswap, swap_finalize) that remain predictable.

    Tool Count5/5

    With 8 tools, the server is well-scoped for a DeFi trading platform, covering quoting, swaps, launchpad, portfolio, and market data without excess or deficiency.

    Completeness5/5

    The tool set covers core operations: quotes, single and multi-asset swaps, launchpad creation/trading, portfolio balances, and market/trending information. No obvious operational gaps for the intended domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • @alpha-arcade/mcp

      phara23
      A
      license
      A
      quality
      D
      maintenance
      MCP server for Alpha Arcade prediction markets on Algorand. Enables AI agents to browse markets, fetch orderbooks, place orders, manage positions, and trade on-chain prediction markets.
      20
      67 npm
      10
      MIT

    • Reins MCP

      onreins
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI agents to manage Mandates and execute USDC-denominated trades on Arc, including checking equity, holdings, active rules, available loss headroom, fetching Chainlink prices, and swapping approved assets. Rule violations such as excessive trade size, insufficient balance approvals, expired deadlines, or transfers involving unauthorized recipients produce clear failure states containing actionable guidance.
      7 npm
      MIT

    • argus

      itsfriedpotato
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to launch tokens, trade, claim creator fees, manage locks, recover projects, and perform on-chain reads on Arc mainnet through 19 prepare/execute/read tools plus optional shared asset tools.
      41 npm
      1
      MIT