# Alpha-Agent-MCP — Install

A free, open-source MCP server that gives any AI agent full access to
Polymarket — market discovery, live price feeds, order books, and explicit
order execution. Published on npm as `alpha-agent-mcp`, source on GitHub
at `5StaronSolana/Alpha-Agent-MCP`.

- Package: https://www.npmjs.com/package/alpha-agent-mcp
- Source: https://github.com/5StaronSolana/Alpha-Agent-MCP
- Homepage: https://join5star.xyz/mcp
- License: MIT

## Requirements

- Node.js >= 24
- Any stdio-capable MCP host (Claude Code, Claude Desktop, Cursor, Grok Build,
  OpenClaw, Hermes, or a custom host you control)

## Quick start

Register the server on Claude Code with a single command:

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

`-s user` scopes the server to the current user so it applies to every project.
It connects immediately — there is no config file to edit and no build step.

## Install on each host

### Claude Code

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

### Cursor

Open Settings → MCP, add a new MCP server, and use this JSON:

```json
{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": ["-y", "alpha-agent-mcp"]
    }
  }
}
```

### Grok Build

Open the MCP settings panel, add a server, and use the same
command/args/env block as Cursor above.

### Claude Desktop

Edit the Claude Desktop config file:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Add:

```json
{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": ["-y", "alpha-agent-mcp"]
    }
  }
}
```

### OpenClaw

Use OpenClaw's MCP settings and add the server with the same
command/args/env block. See the OpenClaw MCP docs for the exact field names
in its config.

### Any other stdio-capable host

Point the host's MCP settings at `npx -y alpha-agent-mcp`. The command/args/env
shape above is identical everywhere MCP is supported.

## Enable trading (optional)

Trading tools only appear when a `PRIVATE_KEY` env var is set. Omit it and
every read-only tool — discovery, prices, order books, live feeds — works
with zero configuration. Set it to unlock explicit order execution on the
client immediately, with no second step.

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

> `PRIVATE_KEY` is a real signing key. Only ever set it in your own MCP host
> config. Never share it, never commit it, never paste it into a chat.

## Build from source

Clone, build, and self-register with Claude Code:

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

The script clones the repository, builds it, and automatically registers the
server with Claude Code if it detects a Claude Code session.

## What you get

- Full Polymarket discovery and pricing — events, markets, order books, spreads
- Explicit order execution and management — never trade-by-intent
- Live market, wallet, sports, and price feeds pushed over MCP Resources (no polling)
- Auth via credentials only — no PRIVATE_KEY means fund-moving methods aren't
  even exposed on the client

## Support

Questions? Ask on Telegram: https://t.me/Join5StarNow