Koskamo

actually-mcp-server

An MCP server for Polymarket that matches news articles to prediction markets and returns market probabilities. It exposes tools for checking news, getting market data, and optionally placing, selling, or cancelling orders via WalletConnect v2. The server runs locally, using a bundled model for text scoring and Chrome's local translator for non-English pages, ensuring data privacy.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

actually-mcp-server logo, by Sofiia7Community listingLocal stdioSource reviewed; not executedPublished by Sofiia7
You need:Trading tools appear only if you supply a key of your own
Vendor documentation

What you can do with it

  • Check news sentiment against Polymarket odds
  • Get current market probabilities for specific questions
  • Place limit or market orders on Polymarket
  • View positions and P&L in an agent context

Source and maintenance

Community listingRegistry 0.1.10
Maintenance checked

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

actually-mcp-server 0.1.10

npm
actually-mcp-server package definition
{
  "version": "0.1.10",
  "transport": "stdio",
  "identifier": "actually-mcp-server",
  "registryType": "npm",
  "environmentVariables": [
    {
      "name": "POLYMARKET_PRIVATE_KEY",
      "format": "string",
      "description": "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."
    },
    {
      "name": "ACTUALLY_MAX_ORDER_USD",
      "format": "number",
      "description": "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."
    },
    {
      "name": "ACTUALLY_DAILY_LIMIT_USD",
      "format": "number",
      "description": "Optional. Rolling UTC-day USD cap shared by place_order and sell_order (default 500). Held in a persisted ledger, so it survives restarts."
    },
    {
      "name": "ACTUALLY_ENABLE_REDEEM",
      "format": "string",
      "description": "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."
    },
    {
      "name": "ACTUALLY_SEARCH_FALLBACK",
      "format": "string",
      "description": "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."
    },
    {
      "name": "ACTUALLY_SPEND_STATE_PATH",
      "format": "string",
      "description": "Optional. Where the spend ledger is stored (default ~/.actually-mcp-server/spend-guard.json)."
    },
    {
      "name": "ACTUALLY_WORKER_URL",
      "format": "string",
      "description": "Optional. Only if you run your own Cloudflare Worker instead of the shared default."
    },
    {
      "name": "ACTUALLY_WORKER_SECRET",
      "format": "string",
      "description": "Optional. Shared secret for your own Worker. Not a private credential: the default one ships inside every client by design."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.
Cursor configuration
{
  "mcpServers": {
    "actually-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server@0.1.10"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<YOUR_ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<YOUR_ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<YOUR_ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<YOUR_ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<YOUR_ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<YOUR_ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.
Cline configuration
{
  "mcpServers": {
    "actually-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server@0.1.10"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<YOUR_ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<YOUR_ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<YOUR_ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<YOUR_ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<YOUR_ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<YOUR_ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.
VS Code configuration
{
  "servers": {
    "actually-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server@0.1.10"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<YOUR_ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<YOUR_ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<YOUR_ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<YOUR_ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<YOUR_ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<YOUR_ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.
Claude Desktop configuration
{
  "mcpServers": {
    "actually-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "actually-mcp-server@0.1.10"
      ],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>",
        "ACTUALLY_MAX_ORDER_USD": "<YOUR_ACTUALLY_MAX_ORDER_USD>",
        "ACTUALLY_DAILY_LIMIT_USD": "<YOUR_ACTUALLY_DAILY_LIMIT_USD>",
        "ACTUALLY_ENABLE_REDEEM": "<YOUR_ACTUALLY_ENABLE_REDEEM>",
        "ACTUALLY_SEARCH_FALLBACK": "<YOUR_ACTUALLY_SEARCH_FALLBACK>",
        "ACTUALLY_SPEND_STATE_PATH": "<YOUR_ACTUALLY_SPEND_STATE_PATH>",
        "ACTUALLY_WORKER_URL": "<YOUR_ACTUALLY_WORKER_URL>",
        "ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>"
      }
    }
  }
}

Let your agent find its tools

Find servers like actually-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.