@alpha-arcade/mcp

MCP (Model Context Protocol) server for Alpha Arcade prediction markets on Algorand.

Lets AI agents (Claude, Cursor, Copilot, etc.) browse markets, place orders, manage positions, and trade on-chain prediction markets.

Tools

| Tool | Description | Requires Wallet | |------|-------------|:---:| | get_markets | Fetch all live tradeable markets | No | | get_market | Fetch a single market by ID | No | | get_orderbook | Get the full on-chain orderbook for a market | No | | get_open_orders | Get open orders for a wallet on a market | No | | get_positions | Get YES/NO token positions for a wallet | No | | create_limit_order | Place a limit order on a market | Yes | | create_market_order | Place a market order with auto-matching | Yes | | cancel_order | Cancel an open order | Yes | | propose_match | Match two existing orders | Yes | | split_shares | Split USDC into YES + NO tokens | Yes | | merge_shares | Merge YES + NO tokens back into USDC | Yes | | claim | Redeem outcome tokens from a resolved market | Yes |

Setup

Environment Variables

| Variable | Required | Description | |----------|:--------:|-------------| | ALPHA_MNEMONIC | For trading | 25-word Algorand mnemonic | | ALPHA_API_KEY | No | Alpha partners API key. If set, markets are fetched via API (richer data). If omitted, markets are discovered on-chain. | | ALPHA_ALGOD_SERVER | No | Algod URL (default: mainnet Algonode) | | ALPHA_INDEXER_SERVER | No | Indexer URL (default: mainnet Algonode) | | ALPHA_MATCHER_APP_ID | No | Matcher app ID (default: 3078581851) | | ALPHA_USDC_ASSET_ID | No | USDC ASA ID (default: 31566704) |

Cursor (read-only, zero config)

Add to your .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"]
    }
  }
}

That's it -- no API key needed. Your AI can browse markets, view orderbooks, and check positions.

Cursor (with trading)

To enable trading, add your mnemonic:

{
  "mcpServers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"],
      "env": {
        "ALPHA_MNEMONIC": "your twenty five word mnemonic here"
      }
    }
  }
}

Claude Desktop / Claude Code

Same config works for both Claude Desktop (GUI app) and Claude Code (terminal CLI).

Add to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS (or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"],
      "env": {
        "ALPHA_MNEMONIC": "your twenty five word mnemonic here"
      }
    }
  }
}

For Claude Code specifically, you can also add it via the CLI:

claude mcp add alpha-arcade -- npx -y @alpha-arcade/mcp

VS Code / Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "alpha-arcade": {
      "command": "npx",
      "args": ["-y", "@alpha-arcade/mcp"],
      "env": {
        "ALPHA_MNEMONIC": "your twenty five word mnemonic here"
      }
    }
  }
}

Zero Config Mode

With no environment variables at all, the server works in read-only mode. Markets are discovered directly from the Algorand blockchain -- no API key needed. You can browse markets, view orderbooks, and check positions. Trading tools will return an error explaining that a mnemonic is required.

Price and Quantity Units

All prices and quantities use microunits (1,000,000 = $1.00 or 1 share):

• Price 500000 = $0.50
• Quantity 1000000 = 1 share
• Slippage 50000 = $0.05

Links

• SDK: npmjs.com/package/@alpha-arcade/sdk
• GitHub: github.com/phara23/alpha-mcp
• Alpha Arcade: alphaarcade.com