Actually MCP Server

by sofiia7io.github.Sofiia7/actuallyv0.1.10

MCP server that matches news text to Polymarket prediction markets and returns the market's current probability - plus optional trading tools (place, sell, redeem) using your own wallet.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Actually MCP server

claude mcp add actually -e POLYMARKET_PRIVATE_KEY='<polymarket-private-key>' -e ACTUALLY_WORKER_SECRET='<actually-worker-secret>' -- npx -y actually-mcp-server

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<polymarket-private-key>",
        "ACTUALLY_WORKER_SECRET": "<actually-worker-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<polymarket-private-key>",
        "ACTUALLY_WORKER_SECRET": "<actually-worker-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "actually": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<polymarket-private-key>",
        "ACTUALLY_WORKER_SECRET": "<actually-worker-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<polymarket-private-key>",
        "ACTUALLY_WORKER_SECRET": "<actually-worker-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
POLYMARKET_PRIVATE_KEY	—	yes	Optional. Your own Polygon EOA private key. Enables the trading tools (place_order, sell_order, cancel_order, get_open_orders, get_positions). Omit to run signal-only, which needs no key and no wallet.
ACTUALLY_MAX_ORDER_USD	—	—	Optional. Per-order USD cap for the trading tools (default 100). Enforced server-side against the market's own price, so a caller cannot understate an order to slip past it.
ACTUALLY_DAILY_LIMIT_USD	—	—	Optional. Rolling UTC-day USD cap shared by place_order and sell_order (default 500). Held in a persisted ledger, so it survives restarts.
ACTUALLY_ENABLE_REDEEM	—	—	Optional. Set to exactly 'true' to additionally register redeem_position. A second opt-in beyond the private key, because it submits a real on-chain transaction through Polymarket's relayer and is still in testing.
ACTUALLY_SEARCH_FALLBACK	—	—	Optional. Set to exactly 'true' to let check_news fall back to Polymarket's own market search when nothing in the cached set matches. Off by default: the query is built from the caller's text and leaves the machine.
ACTUALLY_SPEND_STATE_PATH	—	—	Optional. Where the spend ledger is stored (default ~/.actually-mcp-server/spend-guard.json).
ACTUALLY_WORKER_URL	—	—	Optional. Only if you run your own Cloudflare Worker instead of the shared default.
ACTUALLY_WORKER_SECRET	—	yes	Optional. Shared secret for your own Worker. Not a private credential: the default one ships inside every client by design.

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-08-26 · 44d ago · GitHub · v0.1.7
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 4d ago · official registry · v0.1.10

FAQ

›How do I install the Actually MCP server in Claude Code?

Run: claude mcp add actually -e POLYMARKET_PRIVATE_KEY='<polymarket-private-key>' -e ACTUALLY_WORKER_SECRET='<actually-worker-secret>' -- npx -y actually-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Actually require an API key?

Yes. It expects POLYMARKET_PRIVATE_KEY, ACTUALLY_WORKER_SECRET, of which 2 are secrets.

›Can I use Actually as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Actually in the official MCP registry?

Yes, as io.github.Sofiia7/actually.