Repository avatar
Other Tools
v1.2.0
active

mcp

online.disputes/mcp

Read prediction disputes and the crowd's odds on real-world events from disputes.online.

Documentation

disputes.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

ToolWhat it does
search_disputesDisputes open to bets, filtered by language, category and country, sorted by pool size, number of bets or closing time
search_disputes_by_tagsOpen disputes carrying any of the given tags
get_disputeOne dispute by id or page URL — open, or already settled, with the winning outcome
list_categoriesThe 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

VariableDefaultMeaning
APP_PORT8098Port to listen on
API_PATH/mcpPath the protocol is served at
DISPUTES_URLhttp://disputes:8080Base URL of the dispute service
CATEGORIES_URLhttp://categories:8082Base URL of the category service
HISTORY_URLhttp://history:8095Base URL of the history service (settled disputes)
PLATFORM_TIMEOUT5sTimeout for one call to either service
RATE_LIMIT_RPS / RATE_LIMIT_BURST20 / 40Limit 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

No installation packages available.

Remote