Actually

io.github.Sofiia7/actually · v0.1.10

Matches news to Polymarket markets and returns the market's probability. Optional capped trading.

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add actually -e POLYMARKET_PRIVATE_KEY=<POLYMARKET_PRIVATE_KEY> -e ACTUALLY_MAX_ORDER_USD=<ACTUALLY_MAX_ORDER_USD> -e ACTUALLY_DAILY_LIMIT_USD=<ACTUALLY_DAILY_LIMIT_USD> -e ACTUALLY_ENABLE_REDEEM=<ACTUALLY_ENABLE_REDEEM> -e ACTUALLY_SEARCH_FALLBACK=<ACTUALLY_SEARCH_FALLBACK> -e ACTUALLY_SPEND_STATE_PATH=<ACTUALLY_SPEND_STATE_PATH> -e ACTUALLY_WORKER_URL=<ACTUALLY_WORKER_URL> -e ACTUALLY_WORKER_SECRET=<ACTUALLY_WORKER_SECRET> -- npx -y [email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "actually": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`POLYMARKET_PRIVATE_KEY` Optional, secret	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	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	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	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	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	Optional. Where the spend ledger is stored (default ~/.actually-mcp-server/spend-guard.json).
`ACTUALLY_WORKER_URL` Optional	Optional. Only if you run your own Cloudflare Worker instead of the shared default.
`ACTUALLY_WORKER_SECRET` Optional, secret	Optional. Shared secret for your own Worker. Not a private credential: the default one ships inside every client by design.

Details

Package	`[email protected]` (NPM, stdio)
First published	5 Oct 2026
Last updated	5 Oct 2026
Registry name	`io.github.Sofiia7/actually`

More search and web servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Actually often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-sofiia7-actually/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-sofiia7-actually)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.