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.
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
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
actually-mcp-server 0.1.10
{
"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.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"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
{
"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
{
"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
{
"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.