About disputes.online
disputes.online is a public, read-only MCP server for AI agents to explore open or settled prediction disputes and crowd-implied odds. It reads from the public API used by the site and cannot place bets or act for users.
Key features
- 01Filter open disputes by language, category, and country
- 02Sort by pool size, bet count, or closing time
- 03Search disputes by tags
- 04Look up disputes and outcomes by ID or page URL
- 05View implied probabilities and payout multipliers
Use cases
- 01Track open disputes in a category or country
- 02Compare crowd odds across possible outcomes
- 03Check winning outcomes for settled disputes
MCP support
The MCP server exposes dispute search, category listing, and dispute detail tools over an unauthenticated Streamable HTTP endpoint. It reads only from disputes.online's public API and offers no tools for betting or creating disputes.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://disputes.online/mcpclaude mcp add --transport http online-disputes https://disputes.online/mcp{"mcpServers":{"online-disputes":{"type":"http","url":"https://disputes.online/mcp"}}}Open in Cursor{"servers":{"online-disputes":{"type":"http","url":"https://disputes.online/mcp"}}}Open in VS Code{"mcpServers":{"online-disputes":{"type":"http","url":"https://disputes.online/mcp"}}}{"mcpServers":{"online-disputes":{"serverUrl":"https://disputes.online/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| dispute | string | Yes | the dispute's id (UUID) or the URL of its page on disputes.online |
Details
From the project READMEdisputes.online MCP server
A public, read-only Model Context Protocol server for disputes.online. It lets an AI agent find open disputes and read how the stakes on them are split — the crowd's implied odds.
Endpoint: https://disputes.online/mcp (Streamable HTTP, no authentication)
Tools
| Tool | What it does |
|---|---|
search_disputes | Disputes open to bets, filtered by language, category and country, sorted by pool size, number of bets or closing time |
search_disputes_by_tags | Open disputes carrying any of the given tags |
get_dispute | One dispute by id or page URL — open, or already settled, with the winning outcome |
list_categories | The category tree, to find a category_id |
Every dispute comes with its page URL and, per outcome, the share of stakes
(implied_probability) and the payout multiplier. Amounts are in QOT, the platform's internal
currency. Lists default to English; pass lang for disputes written in another language.
There are no tools that place bets, create disputes or act for a user.
Connecting
Claude Code:
claude mcp add --transport http disputes-online https://disputes.online/mcp
Any client that takes a JSON config:
{ "mcpServers": { "disputes-online": { "type": "http", "url": "https://disputes.online/mcp" } } }
How it works
The server has no database access. It calls the same public API the site uses
(https://disputes.online/openapi.json), so it can only say what the site already publishes.
It is stateless: any replica answers any request.
Configuration
| Variable | Default | Meaning |
|---|---|---|
APP_PORT | 8098 | Port to listen on |
API_PATH | /mcp | Path the protocol is served at |
DISPUTES_URL | http://disputes:8080 | Base URL of the dispute service |
CATEGORIES_URL | http://categories:8082 | Base URL of the category service |
HISTORY_URL | http://history:8095 | Base URL of the history service (settled disputes) |
PLATFORM_TIMEOUT | 5s | Timeout for one call to either service |
RATE_LIMIT_RPS / RATE_LIMIT_BURST | 20 / 40 | Limit on the total request rate |
GET /health answers ok.
Running locally
APP_PORT=8098 \
DISPUTES_URL=https://disputes.online/disputes \
CATEGORIES_URL=https://disputes.online/category \
HISTORY_URL=https://disputes.online/history \
go run ./cmd
Then point a client, or npx @modelcontextprotocol/inspector, at http://localhost:8098/mcp.
Publishing to the MCP registry
server.json describes this server for the official MCP registry
under the name online.disputes/mcp. That namespace belongs to whoever controls disputes.online:
the site serves a public key at https://disputes.online/.well-known/mcp-registry-auth, and
publishing takes the matching private key, kept outside this repository at
~/.mcp-registry/disputes.online.pem.
brew install mcp-publisher
./publish.sh
Bump version in server.json before publishing again; the registry refuses a version it already has.
Tests
go test ./...
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.