Premium · 17 read tools · live on orakll.com

Labelled data for trading agents.

Raw prices are a commodity — every agent has them. Orakll gives your agent the labels: why each Polymarket market moved, and a ground-truth corpus of how every meaningful market resolved. Backtest against what actually happened. Wire it in with one token.

Subscribe — $20/mo →Read the docs →

$20/month · cancel anytime

Ground truth

Backtest against what happened

Every meaningful market that resolved, labelled with why it resolved and how honestly it was priced. Your agent stops guessing and starts testing theses against the record.

The why

Not just the number

Real-time articles explain every major move — sourced, tape-checked. The price is a commodity; the reason behind it is the edge.

Zero infra

One token, every read

Hosted MCP, Markdown, REST — 17 read tools behind one bearer token. No clone, no build, no pipeline to babysit.

Get on premium

Subscribe to Orakll — create your account right after checkout. See pricing.

Add the hosted MCP

Zero install · recommended

Paste into ~/.claude/mcp.json (Cursor, ChatGPT, OpenAI Agents take the same shape). Swap in your PAT, then restart the agent.

~/.claude/mcp.json

{
  "mcpServers": {
    "orakll": {
      "url": "https://orakll.com/api/mcp",
      "headers": { "Authorization": "Bearer ppc_pat_…" }
    }
  }
}

Read tools

Seventeen read-only tools in three families — the newsroom, live markets & charts, and the labelled resolution corpus. Market and resolution tools return structuredContent so your agent trades on parsed data, not prose.

Newsroom

search_articlesFull-text search across the wire.
list_recent_articlesNewest first, optionally by desk.
get_articleOne article — body, conditionId, market URL.
list_categoriesThe 9 desks.

Markets & charts

screen_marketsLive markets ranked by 24h volume, by desk.
list_moversThe biggest 24h movers right now.
get_marketFull detail — odds, volume, resolution, dates.
get_market_chart7-day series + computed summary (the chart's content).
analyze_marketChart + book pressure + trade tape + VWAP — one read.
get_order_bookDepth ladder — bids/asks, mid, spread, pressure.
get_top_holdersTop YES/NO holders — whale concentration.
market_calibrationReliability read — do N¢ markets resolve YES ~N%? Brier per desk.
market_term_structureCompare 2–8 related markets across expiries — curve + hazard.
explain_metricsThe metric glossary — what each reading means, how it's read.
coverage_for_marketOrakll's articles on a given market.

Resolution corpus

The labelled data layer no other Polymarket tool offers — every meaningful market that resolved, tagged with why and how honestly it was priced. Backtest a thesis against what actually moved.

list_resolutionsQuery resolved markets — filter by desk, keyword, outcome, date window, volume; sort by recent / volume / biggest move. Each labelled with its decisive cause + outcome.
explain_resolutionWhy it resolved — sourced causal events + per-market reliability read.

REST

Same PAT, plain JSON. Full reference in the docs.

curl -H "Authorization: Bearer ppc_pat_…" \
  https://orakll.com/api/v1/feed?limit=5

Markdown mirror

Every article slug has a .md twin. The preview is free; the full body needs a premium PAT.

# Full body — premium PAT
curl -H "Authorization: Bearer ppc_pat_…" \
  https://orakll.com/article/<slug>.md

# Preview — no token required
curl https://orakll.com/article/<slug>.md

Advanced — stdio fallback→

Clone ppc-mcpand run it over stdio — the four newsroom tools, no network hop, for strict egress. The markets & charts tools are hosted-MCP only. Repo is invite-only.

{
  "mcpServers": {
    "orakll": {
      "command": "node",
      "args": ["/absolute/path/to/ppc-mcp/dist/index.js"],
      "env": {
        "ORAKLL_TOKEN": "ppc_pat_…",
        "ORAKLL_API_URL": "https://orakll.com/api"
      }
    }
  }
}

Questions

What is labelled resolution data?

For every meaningful market that resolved, Orakll records the decisive cause, the sourced news events that drove it, and a per-market reliability read — was the price honest, and when did it know. Ground truth plus causality your agent can backtest against, not just the closing price. Browse it at /resolutions.

Which agents and clients work?

Anything that speaks MCP — Claude Code, Cursor, ChatGPT, OpenAI Agents — connects to the hosted Streamable-HTTP endpoint at /api/mcp with a URL and a bearer token. For everything else there is plain REST and the Markdown mirror, all behind the same PAT.

Is the market data real-time?

The markets & charts tools read live Polymarket data (Gamma + CLOB + Data-API) on each call. The newsroom and the resolution corpus update as Orakll’s engine publishes coverage and labels resolved markets.

How does authentication work?

One premium personal access token (ppc_pat_…), minted at /account/tokens and sent as Authorization: Bearer. User-scoped, hashed at rest, revocable, and re-checked on every request — so a downgrade kills outstanding tokens.

What does it cost?

The MCP, PATs, REST, and full Markdown bodies are premium — $20/month, cancel anytime. The newsroom and the .md preview are free. See pricing.

Give your agent an edge

Stop trading on raw prices.

Labelled moves, ground-truth resolutions, 17 read tools — one token, 30-second setup.

Subscribe — $20/mo →See pricing →

Labelled data for trading agents.

$20/month · cancel anytime

{ "mcpServers": { "orakll": { "command": "node", "args": ["/absolute/path/to/ppc-mcp/dist/index.js"], "env": { "ORAKLL_TOKEN": "ppc_pat_…", "ORAKLL_API_URL": "https://orakll.com/api" } } } }