# Oracle3 prediction-market arbitrage checks

> Oracle3 prediction-market arbitrage checks is an open-source MCP server for finance and payments. Kalshi and Polymarket data, fee-aware arbitrage checks and paper trading for AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://yichengyang-ethan.github.io/oracle3-prediction-market-agent/
- **Repository:** https://github.com/yichengyang-ethan/oracle3-prediction-market-agent
- **MCP Registry name:** io.github.YichengYang-Ethan/oracle3
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-16

## About

Oracle3 gives agents a research and simulation workflow for prediction markets. Thirteen MCP tools find contracts, read their resolution rules, quotes and order books, calculate venue fees, and run five kinds of relationship checks across related contracts, returning a candidate basket, per-leg fees and a calculated net edge. Orders are simulated in a local paper ledger kept in a JSON file.

The README's synthetic example shows the idea: with an implication between two contracts, a $5.00 gross edge minus $3.4125 in fees leaves $1.5875, conditional on the supplied quotes. Public market reads need no exchange credentials. Real-order execution is separate and lives in the CLI and Python engine, which also supports strategy development with risk controls and paper or live venue adapters.

The project also ships six reusable agent Skills for market research, strategy authoring and operations. It installs from a development checkout or PyPI and needs Python 3.10 or later.

## Features

- **Market discovery:** Searches contracts and reads their details and resolution rules.
- **Quotes and order books:** Shows prices, fee information and displayed depth.
- **Constraint checks:** Runs five relationship checks and reports net edge after fees.
- **Fee calculator:** Estimates trading fees and parameterised fair values.
- **Paper trading:** Simulates entries and holdings in a local ledger.
- **Python engine:** Builds strategies with risk controls and venue adapters.

## Good for

- Compare resolution rules across Kalshi and Polymarket contracts
- Check whether related contracts leave a fee-adjusted edge
- Practise a strategy with paper orders before any live use
- Build and test a prediction-market strategy in Python

## Install

### Claude Code (Terminal)

```sh
claude mcp add oracle3 -- uvx oracle3
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oracle3": {
      "command": "uvx",
      "args": [
        "oracle3"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oracle3": {
      "command": "uvx",
      "args": [
        "oracle3"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oracle3": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oracle3"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oracle3": {
      "command": "uvx",
      "args": [
        "oracle3"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oracle3": {
      "command": "uvx",
      "args": [
        "oracle3"
      ]
    }
  }
}
```

## Tools

- `search_markets`: Discover markets and contracts.
- `get_market`: Get a contract's metadata and resolution rules.
- `get_quote`: Get prices and fee information.
- `get_orderbook`: Show order book depth.
- `check_constraint`: Check a stated relationship between contracts for net edge.
- `check_constraint_live`: Run a relationship check against live quotes.
- `trading_fee`: Calculate venue trading fees.
- `fair_value`: Compute parameterised model values.
- `paper_order`: Place a simulated order in the local ledger.
- `paper_portfolio`: Show simulated holdings.

## FAQ

### Does MCP place real orders?

No. MCP provides data, calculations and a local paper ledger. Real orders use the separate CLI and Python engine.

### Do I need exchange credentials?

Not for public market reads.

### How many tools are there?

13 MCP tools and 6 agent Skills.

### What does it need?

Python 3.10 or later.

### Is Oracle3 prediction-market arbitrage checks free?

Yes. Oracle3 prediction-market arbitrage checks is open source, so you can use and self-host it for free.

### How do I add Oracle3 prediction-market arbitrage checks to Claude Code?

Run this command in your terminal: claude mcp add oracle3 -- uvx oracle3

### What are the best alternatives to Oracle3 prediction-market arbitrage checks?

The closest alternatives to Oracle3 prediction-market arbitrage checks are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/oracle3-prediction-market-arbitrage-checks
