English Français العربية

disputes.online

Official registry Other

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http disputes-online 'https://disputes.online/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "disputes-online": {
            "type": "http",
            "url": "https://disputes.online/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. disputes.online MCP server
  2. Tools
  3. Connecting
  4. How it works
  5. Configuration
  6. Running locally
  7. Publishing to the MCP registry
  8. Tests
  9. License

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

Frequently asked questions

What is disputes.online?

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

How do I install disputes.online?

It runs as a remote server. In Claude Code: claude mcp add --transport http disputes-online 'https://disputes.online/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does disputes.online need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is disputes.online open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains disputes.online?

It is published by peccancy. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.