5 Star

Bearing 270

Alpha-Agent-MCP

Free, open source, live on npm. A generic MCP server exposing the full Polymarket SDK — connect it to any MCP-compatible client for prediction-market discovery, live feeds, and trading. Built for our own trading, opened up completely.

Full SDK, zero drift

Every method on @polymarket/client is reachable generically — discover with one tool, dispatch by name with another. Nothing hand-written per method to fall out of sync.

Read/write separated

Reads and writes are different tools, not one tool doing both — nothing that moves funds runs without an explicit write call and a private key.

Live feeds

Order books, market data, and your own account activity pushed as MCP resources — auto-subscribed the moment you place an order.

Zero-config to start

Discovery and read tools work with no setup at all. Add a wallet key only when you want trading and account tools too.

Install

Pick the block for whichever tool you're running. PRIVATE_KEY / WALLET_ADDRESS are optional — leave them out to run fully read-only with zero setup.

Claude Code

claude mcp add polymarket -s user -- npx -y alpha-agent-mcp

Codex CLI — ~/.codex/config.toml

[mcp_servers.polymarket]
command = "npx"
args = ["-y", "alpha-agent-mcp"]

[mcp_servers.polymarket.env]
PRIVATE_KEY = "0x..."
WALLET_ADDRESS = "0x..."

Cursor / Claude Desktop / Grok Build

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": ["-y", "alpha-agent-mcp"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "WALLET_ADDRESS": "0x..."
      }
    }
  }
}

One-line installer (any host, self-registers with Claude Code)

curl -fsSL https://join5star.xyz/mcp/install.sh | bash

From source

git clone https://github.com/5StaronSolana/Alpha-Agent-MCP.git
cd Alpha-Agent-MCP && npm install
node dist/index.js
Full docs on GitHubQuestions? Ask in Discord