ForecastOS
GitHubGet started
Real odds. Not hallucinated ones.

Let agents see every future

When you ask your agent what might happen next, ForecastOS makes sure it checks the market, not its training data.

Get ForecastOS
agent · forecast-os.skill

Supported venues

Search prediction markets before your agent decides

Your agent should not have to guess at probabilities. Connect ForecastOS once, and every question you ask gets checked against live market odds before your agent answers.

Polymarket logo

High-signal world events, priced by deep liquidity.

  • Check live odds on the questions that matter most
  • Compare probabilities across multiple outcomes
  • Get market-priced answers, not training-data guesses
Polymarket
Kalshi logo

Regulated event contracts on macro, policy, and real-world outcomes.

  • Regulated contracts on macro and policy questions
  • Cross-check your agent's answer against an independent venue
  • Works alongside Polymarket in a single query
Kalshi
Precog logo

Multi-outcome on-chain markets for agent-drafted questions.

  • Create markets with multiple possible outcomes
  • Fund liquidity once you approve
  • Query, create, and trade through the same workflow
Precog

What's possible

A live probability agents can check before they act

You ask your agent what's likely to happen. Without ForecastOS, it guesses, confidently and wrongly. With it, your agent checks Polymarket, Kalshi, and Precog before answering.

1/4ForecastOS

Query live odds before you decide

ForecastOS searches Polymarket, Kalshi, Precog, and more. Your agent drafts multi-outcome specs and routes your decision through live probability. Fund and trade steps wait for your approval.

  • Ask in plain language, get market-priced odds
  • Compare probabilities across venues in one query
  • Your agent cites the market, not a guess
2/4Launch

Create markets

Post agent-drafted questions with multiple possible outcomes on supported venues. On platforms like Precog, creators can earn a share of the profit pool when a market resolves, with no upfront funding required.

  • Launch markets with multiple outcomes
  • Earn creator share where venues support it
  • Returns are not guaranteed
3/4Participate

Hedge risk with live probability

Outcome shares price the probability each result happens. Prices update as new information arrives, giving you a live signal for hedging or expressing conviction.

  • Buy and sell outcome shares as odds shift
  • Hedge decisions with live market probability
  • Redeem winning shares after resolution
4/4Liquidity

Provide liquidity

Fund the markets your agent queries. Liquidity providers earn the majority of the post-resolution profit pool, plus fees where applicable. Capital is locked until the market resolves.

  • Earn the majority of the profit pool on supported venues
  • Trading fees where applicable
  • Capital locked until the market resolves

The loop

Reviewable by default. Autonomous where it's safe.

You stay in the loop at every stage that matters. Your agent handles the legwork.

01

Discover & draft

You ask a question, or your agent surfaces one. It searches live markets first, then structures multiple outcomes and resolution criteria into a reviewable draft.

02

Review & approve

You review the draft before anything happens. Approve it, request edits, or discard it. Nothing moves forward without you.

03

Deploy market

Once you approve, the action bridge deploys on a supported venue, waits for platform validation, and funds initial liquidity. All with your sign-off.

04

Consume & trade

Your agent surfaces live probability to you via consume_prediction. For any trade or hedge, you approve before it runs.

Get started

Connect ForecastOS to your agent

One prompt to your agent. It clones the repo, follows the install guide, and comes back ready to query live prediction markets.

  1. 1Copy prompt
  2. 2Share with your agent
  3. 3Follow INSTALL.MD

View INSTALL.MD

Optional · Wallet setup

Connect a wallet for live actions

Only needed after ForecastOS is installed and you want to create, fund, or trade markets.

Base MCP for wallet operations with operator-approved signing.

  1. 1.Connect the Base MCP

    Install the Base MCP server from https://docs.base.org/agents/quickstart

  2. 2.Add the base-mcp skill

    I'd like to use Base MCP. For setup notes, please open `https://docs.base.org/agents/skills/SKILL.md` as your reference. If your built-in browser can't reach the page, the Base MCP also exposes a `web_request` tool that can fetch it. If a section points to a related file under `references/` or `plugins/`, open that one too when it's relevant to what I'm asking.

For platform-specific skill install and more details, see the Base MCP quickstart.

agent · base-mcp wallet
# paste: Install Base MCP from quickstart
 ✓ https://mcp.base.org connected
# paste: open docs.base.org/agents/skills/SKILL.md
 ✓ base-mcp skill loaded
$ Show me my wallets

Three layers, cleanly separated

Everything your agent needs to reason about the future — with you in control of what happens next.

The behavior contract

The Skill

Teaches your agent to search live markets before answering probability questions, then structures what it finds into reviewable drafts you can approve, edit, or discard. No platform-specific setup needed.

  • Search live markets before answering
  • Draft multi-outcome markets from a question
  • Advance workflows through review stages

Context infrastructure

MCP Server

Keeps your agent current on which markets exist, what questions are live, and what each platform supports. Read-only and safe to share across agents.

  • Read-only by design, safe to share
  • Templates, schemas, and examples
  • Live platform capability metadata

Trusted execution

Action Bridge

When your agent is ready to act, your approval comes first. The action bridge handles create, fund, and trade operations. The skill and MCP server never touch funds on their own.

  • Your approval required before any live action
  • Clear separation of draft vs. execute
  • Auditable handoff to the bridge
read-only

Search live markets before hallucinating a probability

The MCP server keeps your agent current on what markets exist, what questions are live, and what each venue supports. It is read-only: your agent reads from it and reasons with it, but never uses it to act or touch funds.

Templates

Reusable scaffolds for single and multi-outcome prediction workflows.

Schemas

Typed contracts for markets, outcomes, and resolution payloads.

Examples

Worked end-to-end drafts your agent can reference when building a new market.

Capability metadata

Live description of what supported platforms can currently do.

mcp://forecast-os/resources
forecast-os/
├─ templates/
│  ├─ single-outcome.v2
│  └─ multi-outcome.v2
├─ schemas/
│  ├─ market.json
│  └─ outcome.json
├─ examples/
│  └─ election-2028.draft.json
├─ venues/
│  ├─ polymarket/
│  ├─ kalshi/
│  └─ precog/
└─ capabilities.json  @live