Actually

Mapeia textos de notícias arbitrários para o mercado da Polymarket sobre o qual tratam e retorna a probabilidade desse próprio mercado.

GitHub

Documentação

Actually - O Que os Mercados Realmente Pensam

Uma extensão para Chrome e um servidor MCP que colocam as probabilidades dos mercados de previsão sobre as notícias que você já está lendo.

As notícias dizem que "especialistas estão preocupados" ou que "as probabilidades estão aumentando". Raramente informam um número. O número existe - em um mercado de previsão, onde as pessoas apostam seu próprio dinheiro no resultado. Ele só vive em outra aba, e encontrá-lo significa saber que tal mercado existe em primeiro lugar.

Actually fecha essa lacuna. Abra um artigo, clique no ícone da barra de ferramentas, e a extensão compara o texto com os mercados Polymarket ao vivo e mostra a probabilidade do próprio mercado. Sem conta, sem carteira, sem cadastro.

Adicione ao Chrome pela Chrome Web Store - grátis.

A news article matched to a live Polymarket market

O que ele faz

  • Relaciona um artigo a um mercado. Um modelo de embeddings local (Xenova/all-MiniLM-L12-v2, ~33 MB) pontua o texto do artigo contra o conjunto de mercados em cache, reforçado pela sobreposição de palavras-chave e números - números importam porque o codificador é quase cego a eles, e "cair para $57.500" gera embeddings quase idênticos a "atingir $120.000".

  • Roda no seu dispositivo. O modelo e o runtime WASM são empacotados no momento da compilação - nada é baixado de um CDN na instalação ou em tempo de execução, e nas configurações padrão o texto do artigo nunca sai da sua máquina.

  • Lê páginas em outros idiomas. Elas são traduzidas para o inglês antes da correspondência, usando a própria API Translator integrada do Chrome (local, sem rede). Cada pergunta do Polymarket é escrita em inglês, e o modelo local contém 86 tokens cirílicos de 30522 - uma manchete russa não traduzida gera embeddings que são ruído. Traduzida, a mesma manchete pontua 0,53-0,71 contra o mercado sobre o qual realmente trata, contra um piso de 0,35.

    A German article matched to a Berlin election market

  • Negocia, opcionalmente. Conecte qualquer carteira WalletConnect v2 para ordens limitadas e a mercado, venda, cancelamento de ordens pendentes e um painel de posições com custo médio e P&L. Chaves e fundos nunca são retidos por nós.

  • Também atende agentes. As mesmas capacidades são expostas pelo Model Context Protocol: check_news, get_market, place_order, sell_order, cancel_order, get_positions.

Usando o servidor MCP

O servidor MCP é publicado, então não precisa de clone nem build. Adicione-o a qualquer cliente MCP (Claude Desktop, Cursor e qualquer outra coisa que fale o protocolo):

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": ["actually-mcp-server"]
    }
  }
}

Isso dá ao agente as ferramentas de sinal - check_news e get_market - sem chave e sem carteira. Pergunte "o que os mercados pensam sobre isso?" com uma manchete e ele responde com o preço do próprio mercado.

O primeiro lançamento baixa o pacote e seu runtime de modelo local (cerca de 170 MB), e o primeiro check_news então busca o modelo de 34 MB. Em uma conexão lenta, isso pode levar mais tempo do que um cliente espera para o servidor iniciar; se o seu relatar um timeout, execute npx -y actually-mcp-server uma vez em um terminal, deixe terminar e reinicie o cliente. Lançamentos posteriores iniciam em poucos segundos.

As ferramentas de negociação aparecem somente se você fornecer uma chave própria:

"env": {
  "POLYMARKET_PRIVATE_KEY": "0x...",
  "ACTUALLY_MAX_ORDER_USD": "100",
  "ACTUALLY_DAILY_LIMIT_USD": "500"
}

Ambos os limites são aplicados no lado do servidor contra um registro de gastos persistente, então um agente não pode contorná-los alegando um preço diferente. redeem_position exige uma aceitação explícita adicional (ACTUALLY_ENABLE_REDEEM=true) porque envia uma transação on-chain real e ainda está em testes.

Documentação completa, incluindo todas as variáveis de ambiente e o raciocínio por trás das proteções: packages/mcp-server/README.md.

Listado no registro oficial de MCP como io.github.Sofiia7/actually, no mcpservers.org e no Glama:

Listed on mcpservers.org

actually MCP server

Como tudo se encaixa

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

O trabalho pesado vive em um documento fora da tela porque os service workers do MV3 não podem executar WASM, manter um WebSocket ou sobreviver tempo suficiente para assinar uma ordem.

O cache de mercados contém 2000 mercados abertos com embeddings pré-computados, reconstruído a cada duas horas. A seleção combina três ordenações - volume de 24h, volume vitalício e recência - porque classificar apenas por volume vitalício é a prateleira errada para uma ferramenta de notícias: um mercado aberto esta manhã sob a manchete de hoje não tem histórico e perde para um mercado eleitoral de um ano atrás toda vez.

O Worker existe para que nenhum cliente precise reter uma credencial. Ele faz proxy das APIs do Polymarket, serve o cache pré-computado e atua como assinante remoto para o relayer, então a credencial do builder permanece no servidor e nunca é enviada dentro de uma extensão.

Executando

npm install
npm run models:fetch -w extension   # bundle the embedding model
npm run build -w extension          # type-check + build to extension/dist

Carregue extension/dist como uma extensão não empacotada no Chrome. Copie extension/.env.example para .env.local e preencha primeiro - o build incorpora a URL do Worker, o ID do projeto WalletConnect e o código do builder.

npm test --workspaces               # 822 tests across four workspaces

Privacidade

A descoberta é gratuita e não precisa de conta. Não há scripts de conteúdo: a página é lida somente quando você clica, e apenas na aba ativa. Nas configurações padrão (embeddings locais), o texto do artigo não sai da sua máquina - a tradução, quando a página precisa, também roda localmente pelo tradutor integrado do próprio navegador, independentemente do provedor de embeddings. A telemetria é opcional e desativada por padrão.

Política completa: https://actually-api.sofiaseremeteva.workers.dev/privacy

Status

A extensão está disponível na Chrome Web Store. actually-mcp-server está publicado no npm e listado no registro oficial de MCP.

Resgatar uma posição resolvida está em testes: autenticação do builder, seleção de contrato neg-risk e a proteção de saldo zero são cada uma verificadas contra serviços ao vivo, mas nenhum resgate foi ainda observado coletando fundos de ponta a ponta.

Ver as probabilidades funciona em qualquer lugar. Abrir novas posições segue as próprias restrições do Polymarket: não está disponível, entre outros, nos EUA, Reino Unido, França, Alemanha, Itália, Países Baixos, Bélgica, Polônia, Irlanda, Austrália, Nova Zelândia, Japão, Singapura, Taiwan, Tailândia, Brasil, Rússia e nas províncias canadenses de Ontário, Colúmbia Britânica, Alberta e Quebec - lá, posições existentes ainda podem ser vendidas e ordens pendentes canceladas. Jurisdições sancionadas são bloqueadas por completo. A verificação roda no Worker.

Actually não fornece aconselhamento financeiro.

Licença

Veja LICENSE.