Matches news articles to live Polymarket markets to provide real-time prediction market probabilities and optional trading capabilities.
Also known as Sofiia7/actually, actually-mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.10
- Last commit
- Nov 10, 2026
- License
- MIT
What is Actually MCP?
Actually matches news articles to live Polymarket markets to provide real-time prediction market probabilities and optional trading capabilities.
Summary generated from the project's README
About Actually MCP server
Actually connects news content to live Polymarket data to provide real-time probability scores. It functions as both a Chrome extension and an MCP server, allowing users to see what prediction markets think about current events. The system uses a local embedding model to match article text against a cache of 2000 open markets, prioritizing recent and high-volume activity.
Developers can integrate this server into MCP clients like Claude Desktop or Cursor using npx. While basic tools like check_news and get_market work without any configuration, trading capabilities require a private key and specific environment variables. Users can set safety limits using ACTUALLY_MAX_ORDER_USD and ACTUALLY_DAILY_LIMIT_USD to control spending. The server handles non-English content by utilizing the built-in browser translator to ensure accurate matching against English market questions.
What you can do with it
- 1Analyze news sentiment with market oddsAsk an AI agent to determine the current market probability for a specific news headline.
- 2Monitor financial positions through MCPRetrieve a summary of current market holdings and profit and loss data.
- 3Translate and match international newsMatch news articles written in other languages to English prediction markets.
Written from the project's README. Every use case is checked against a quote from it.
How to install Actually MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Actually MCP in Claude Code
$ claude mcp add --env 'ACTUALLY_WORKER_SECRET=<YOUR_ACTUALLY_WORKER_SECRET>' --env 'POLYMARKET_PRIVATE_KEY=<YOUR_POLYMARKET_PRIVATE_KEY>' actually -- npx -y actually-mcp-serverInstall Actually MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"actually": {
"command": "npx",
"args": [
"-y",
"actually-mcp-server"
],
"env": {
"ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>",
"POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>"
}
}
}
}Install Actually MCP in VS Code
.vscode/mcp.json
{
"servers": {
"actually": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actually-mcp-server"
],
"env": {
"ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>",
"POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>"
}
}
}
}Install Actually MCP in VS Code CLI
$ code --add-mcp '{"name":"actually","type":"stdio","command":"npx","args":["-y","actually-mcp-server"],"env":{"ACTUALLY_WORKER_SECRET":"<YOUR_ACTUALLY_WORKER_SECRET>","POLYMARKET_PRIVATE_KEY":"<YOUR_POLYMARKET_PRIVATE_KEY>"}}'Install Actually MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"actually": {
"command": "npx",
"args": [
"-y",
"actually-mcp-server"
],
"env": {
"ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>",
"POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>"
}
}
}
}Install Actually MCP in Codex
$ codex mcp add actually --env 'ACTUALLY_WORKER_SECRET=<YOUR_ACTUALLY_WORKER_SECRET>' --env 'POLYMARKET_PRIVATE_KEY=<YOUR_POLYMARKET_PRIVATE_KEY>' -- npx -y actually-mcp-serverInstall Actually MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.actually] command = "npx" args = ["-y", "actually-mcp-server"] [mcp_servers.actually.env] ACTUALLY_WORKER_SECRET = "<YOUR_ACTUALLY_WORKER_SECRET>" POLYMARKET_PRIVATE_KEY = "<YOUR_POLYMARKET_PRIVATE_KEY>"
Install Actually MCP in Gemini CLI
$ gemini mcp add -s user -e 'ACTUALLY_WORKER_SECRET=<YOUR_ACTUALLY_WORKER_SECRET>' -e 'POLYMARKET_PRIVATE_KEY=<YOUR_POLYMARKET_PRIVATE_KEY>' actually npx -- -y actually-mcp-serverInstall Actually MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"actually": {
"command": "npx",
"args": [
"-y",
"actually-mcp-server"
],
"env": {
"ACTUALLY_WORKER_SECRET": "<YOUR_ACTUALLY_WORKER_SECRET>",
"POLYMARKET_PRIVATE_KEY": "<YOUR_POLYMARKET_PRIVATE_KEY>"
}
}
}
}Configuration
ACTUALLY_WORKER_SECRETSecretOptional. Shared secret for your own Worker. Not a private credential: the default one ships inside every client by design.
POLYMARKET_PRIVATE_KEYSecretOptional. 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_DAILY_LIMIT_USDOptional. 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_REDEEMOptional. 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_MAX_ORDER_USDOptional. 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_SEARCH_FALLBACKOptional. 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_PATHOptional. Where the spend ledger is stored (default ~/.actually-mcp-server/spend-guard.json).
ACTUALLY_WORKER_URLOptional. Only if you run your own Cloudflare Worker instead of the shared default.
| Name | Description | |
|---|---|---|
| ACTUALLY_WORKER_SECRET | Optional. Shared secret for your own Worker. Not a private credential: the default one ships inside every client by design. | Secret |
| POLYMARKET_PRIVATE_KEY | 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. | Secret |
| 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_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_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. |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablesofiia7/actually is public and reachablegithub.com/sofiia7/actually ↗Pass
- Package names this repository as its sourceactually-mcp-server names sofiia7/actually as sourcenpmjs.com/package/actually-mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/sofiia7/actually ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from actually-mcp-serverPass
- No critical advisory in the package or its dependencies229 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubActually - What Markets Really Think
A Chrome extension and an MCP server that put prediction-market odds on top of the news you are already reading.
News tells you that "experts are concerned" or that "odds are rising". It rarely tells you a number. The number exists - on a prediction market, where people are betting their own money on the outcome. It just lives in another tab, and finding it means knowing such a market exists in the first place.
Actually closes that gap. Open an article, click the toolbar icon, and the extension matches the text against live Polymarket markets and shows the market's own probability. No account, no wallet, no signup.
Add it to Chrome from the Chrome Web Store - free.

What it does
-
Matches an article to a market. A local embedding model (
Xenova/all-MiniLM-L12-v2, ~33 MB) scores the article text against the cached market set, boosted by keyword and number overlap - numbers matter because the encoder is nearly blind to them, and "dip to $57,500" embeds almost identically to "reach $120,000". -
Runs on your device. Model and WASM runtime are bundled at build time - nothing is fetched from a CDN at install or runtime, and on the default settings the article text never leaves the machine.
-
Reads non-English pages. They are translated to English before matching, using Chrome's own built-in
TranslatorAPI (local, no network). Every Polymarket question is written in English, and the local model holds 86 Cyrillic tokens out of 30522 - an untranslated Russian headline embeds to noise. Translated, the same headline scores 0.53-0.71 against the market it is actually about, against a 0.35 floor.
-
Trades, optionally. Connect any WalletConnect v2 wallet for limit and market orders, selling, cancelling resting orders, and a positions panel with cost basis and P&L. Keys and funds are never held by us.
-
Serves agents too. The same capabilities are exposed over the Model Context Protocol:
check_news,get_market,place_order,sell_order,cancel_order,get_positions.
Using the MCP server
The MCP server is published, so it needs no clone and no build. Add it to any MCP client (Claude Desktop, Cursor, and anything else that speaks the protocol):
{
"mcpServers": {
"actually": {
"command": "npx",
"args": ["actually-mcp-server"]
}
}
}
That gives an agent the signal tools - check_news and get_market - with no
key and no wallet. Ask it "what do markets think about this?" with a headline
and it answers with the market's own price.
The very first launch downloads the package and its local model runtime (about
170 MB), and the first check_news then fetches the 34 MB model. On a slow
connection that can take longer than a client waits for a server to start; if
yours reports a timeout, run npx -y actually-mcp-server once in a terminal,
let it finish, and restart the client. Later launches start in a few seconds.
Trading tools appear only if you supply a key of your own:
"env": {
"POLYMARKET_PRIVATE_KEY": "0x...",
"ACTUALLY_MAX_ORDER_USD": "100",
"ACTUALLY_DAILY_LIMIT_USD": "500"
}
Both caps are enforced server-side against a persisted spend ledger, so an
agent cannot talk its way past them by claiming a different price.
redeem_position needs a further explicit opt-in
(ACTUALLY_ENABLE_REDEEM=true) because it submits a real on-chain transaction
and is still in testing.
Full documentation, including every environment variable and the reasoning
behind the guards: packages/mcp-server/README.md.
Listed in the official MCP registry
as io.github.Sofiia7/actually, on mcpservers.org, and on Glama:
How it fits together
extension/ Chrome MV3 extension (React popup, offscreen document)
extension/worker/ Cloudflare Worker - API proxy, rate limiting, market cache
packages/core/ Matching, pricing and Polymarket API logic, shared by both clients
packages/mcp-server/ MCP server, published to npm as actually-mcp-server
packages/market-cache-builder/ Cron job that precomputes the market embeddings
The heavy work lives in an offscreen document because MV3 service workers cannot run WASM, hold a WebSocket, or survive long enough to sign an order.
The market cache is 2000 open markets with precomputed embeddings, rebuilt every two hours. Selection blends three orderings - 24h volume, lifetime volume, and recency - because ranking by lifetime volume alone is the wrong shelf for a news tool: a market opened this morning under today's headline has no history and loses to a year-old election market every time.
The Worker exists so no client has to hold a credential. It proxies Polymarket's APIs, serves the precomputed cache, and acts as a remote signer for the relayer, so the builder credential stays on the server and never ships inside an extension.
Running it
npm install
npm run models:fetch -w extension # bundle the embedding model
npm run build -w extension # type-check + build to extension/dist
Load extension/dist as an unpacked extension in Chrome. Copy
extension/.env.example to .env.local and fill it in first - the build bakes
the Worker URL, the WalletConnect project id and the builder code.
npm test --workspaces # 822 tests across four workspaces
Privacy
Discovery is free and needs no account. There are no content scripts: the page is read only when you click, and only the active tab. On the default settings (local embeddings) the article text does not leave your machine - translation, when the page needs it, also runs locally via the browser's own built-in translator, regardless of embedding provider. Telemetry is opt-in and off by default.
Full policy: https://actually-api.sofiaseremeteva.workers.dev/privacy
Status
The extension is live on the
Chrome Web Store.
actually-mcp-server is published on npm and listed in the official MCP
registry.
Redeeming a resolved position is in testing: builder authentication, neg-risk contract selection and the zero-balance guard are each verified against live services, but no redeem has yet been observed collecting funds end to end.
Viewing odds works everywhere. Opening new positions follows Polymarket's own restrictions: it is unavailable in, among others, the US, the UK, France, Germany, Italy, the Netherlands, Belgium, Poland, Ireland, Australia, New Zealand, Japan, Singapore, Taiwan, Thailand, Brazil, Russia, and the Canadian provinces of Ontario, British Columbia, Alberta and Quebec - there, existing positions can still be sold and resting orders cancelled. Sanctioned jurisdictions are blocked entirely. The check runs on the Worker.
Actually does not provide financial advice.
Polymarket tool directories
- PolyMart: a directory of Polymarket tools.
- Prediction Market Tools: a directory of prediction market projects.
- PredAtlas: Actually's profile in a directory of prediction market tools.
License
See LICENSE.
Actually MCP questions
How do I add Actually MCP to Claude Code?
Run claude mcp add --env 'ACTUALLY_WORKER_SECRET=<YOUR_ACTUALLY_WORKER_SECRET>' --env 'POLYMARKET_PRIVATE_KEY=<YOUR_POLYMARKET_PRIVATE_KEY>' actually -- npx -y actually-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Actually MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the server require an API key or wallet to view market probabilities?
No, viewing odds and checking news works with no key and no wallet.
Is my news data private when using the server?
On default settings, the article text never leaves your machine because the model and runtime are local.