Actually

io.github.Sofiia7由 GitHub 账号 Sofiia7 发布v0.1.10更新于 Oct 24, 2026

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

已验证STDIO仅桌面网页搜索与抓取金融

概览

AI 生成的概览

把新闻标题匹配到 Polymarket 预测市场并返回其概率,可选地通过自己的 Polygon 私钥进行有额度上限的交易。

可以做什么
  • 将新闻文本匹配到预测市场并读取市场自身概率
  • 查询指定市场的详情与价格
  • 下单、卖出、撤销 Polymarket 订单,并列出未成交订单与持仓(仅在提供私钥时可用)
  • 在额外显式开启后赎回已结算持仓
适用场景
适合希望让助手为某条新闻或文章附上具体的市场隐含概率,或查询预测市场对某事件的定价。交易工具面向已持有 Polymarket 钱包、希望由智能体在额度上限内下单的用户。
运行要求
通过 npx actually-mcp-server 以 stdio 在本地运行,需要 Node.js 和网络访问。首次启动会下载约 170 MB 的软件包与模型运行时,首次调用 check_news 再下载 34 MB 模型,可能超过客户端启动超时。信号类工具无需密钥或钱包。交易需 POLYMARKET_PRIVATE_KEY;可选上限 ACTUALLY_MAX_ORDER_USD 与 ACTUALLY_DAILY_LIMIT_USD,以及 ACTUALLY_ENABLE_REDEEM、ACTUALLY_SPEND_STATE_PATH、ACTUALLY_WORKER_URL、ACTUALLY_WORKER_SECRET。
安装前请注意
交易需要提供 POLYMARKET_PRIVATE_KEY,即 Polygon 钱包私钥,服务器可据此签名并提交真实订单、动用真实资金;建议使用专用钱包并保持较低的美元上限。redeem_position 会提交链上交易,且说明中称仍在测试。开仓在多个司法辖区受限,包括美国、英国、台湾等。启用 ACTUALLY_SEARCH_FALLBACK 时会把调用方文本发送至 Polymarket 搜索。不构成财务建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Actually,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Actually - 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.

[A news article matched to a live Polymarket market]

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 Translator API (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.

    [A German article matched to a Berlin election market]

  • 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):

json
{  "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:

json
"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:

[Listed on mcpservers.org]

[actually MCP server]

How it fits together

extension/            Chrome MV3 extension (React popup, offscreen document)extension/worker/     Cloudflare Worker - API proxy, rate limiting, market cachepackages/core/        Matching, pricing and Polymarket API logic, shared by both clientspackages/mcp-server/  MCP server, published to npm as actually-mcp-serverpackages/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

bash
npm installnpm run models:fetch -w extension   # bundle the embedding modelnpm 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.

bash
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.

License

See LICENSE.

来源:README.md,提交 5648478

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

3
  1. v0.1.10最新Oct 5, 2026
  2. v0.1.9Sep 28, 2026
  3. v0.1.7Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分