# Prediction Council — MCP server

Run the [Prediction Council](https://predictioncouncil.com) 4-model AI council
(Grok, Claude, GPT, Gemini) from any MCP client — Claude Code, Claude Desktop,
Cursor, or your own agent. Search live Polymarket events, run the council on
one, and get back a structured, later-publicly-graded verdict.

## Install & run

```bash
uvx --from git+https://github.com/daveb1392/predictioncouncil-mcp predictioncouncil-mcp
```

Claude Code:

```bash
claude mcp add predictioncouncil \
  -e POLYINSIGHT_API_KEY=pc_live_... \
  -- uvx --from git+https://github.com/daveb1392/predictioncouncil-mcp predictioncouncil-mcp
```

Claude Desktop / generic client — see `example_config.json`.

## Auth

Mint an API key at [predictioncouncil.com/profile](https://predictioncouncil.com/profile)
and set `POLYINSIGHT_API_KEY=pc_live_...`. Event browsing is free and needs no
key; running a report spends credits (or your metered API subscription).

## Tools

| Tool | Auth | Cost | What it does |
|------|------|------|--------------|
| `polyinsight_search_events` | none | free | Search/browse events; get an `event_id` |
| `polyinsight_get_event` | none | free | Event detail + sub-markets and live YES prices |
| `polyinsight_check_report` | key | free | Same-day cache check + the current dynamic quote |
| `polyinsight_run_council_report` | key | dynamic quote (half if cached) | Flagship: run the council, poll to completion, return the verdict |
| `polyinsight_get_report` | key | free | Fetch/poll a report by id |
| `polyinsight_list_reports` | key | free | List your reports |
| `polyinsight_get_credit_balance` | key | free | Paid + free credit balance |

Pricing is dynamic (cost-indexed): always call `check_report` before
`run_council_report`. Rate limit: 5 runs/hour. Failed runs auto-refund.

## Claude Code skill

`skills/predictioncouncil/` contains an installable Claude skill that teaches
Claude when and how to use this server well:

```bash
cp -r skills/predictioncouncil ~/.claude/skills/
```

Full API docs: [predictioncouncil.com/developers](https://predictioncouncil.com/developers)