Oracle3

Oracle3 is an open-source paper-trading engine and MCP server for prediction markets. It maps logical relations between event contracts on Kalshi and Polymarket, checks whether quoted prices break the axioms of probability after each venue's fees, and paper-trades the baskets that survive under pre-trade risk limits.

Status

Paper-traded research software with no live track record. The MCP server cannot place real orders. See what is verified and what is not.

Install

pip install oracle3

Find markets

oracle3 market search --exchange kalshi --query "fed" --json
oracle3 market search --exchange polymarket --query "fed decision" --json

Check a relation between two contracts

from oracle3.arbitrage import Quote, check_constraint
from oracle3.fees import KalshiSchedule

# A implies B, but A is bid at 0.60 while B is offered at 0.55.
result = check_constraint(
    "implication",
    [Quote("A", yes_bid=0.60, schedule=KalshiSchedule()),
     Quote("B", yes_ask=0.55, schedule=KalshiSchedule())],
)
print(result.best.gross_edge, result.best.fees, result.best.net_edge)
# 0.05 0.0342 0.0158

Use it from an AI agent

claude mcp add oracle3 -- uvx oracle3 mcp

The MCP server exposes 13 tools: market search, quotes, order books, fee-aware constraint checks and a local paper ledger.

Read next

• MCP server: tools, client configuration and a worked example
• Do prediction-market arbitrage edges survive fees?: break-even violations under the published fee schedules
• CLI quick start and monitoring
• Project specification: module reference