disputes.online MCP server
Commit Oct 5, 2026Allows an AI agent to search for open prediction disputes and view crowd-implied odds and payout multipliers for real-world events.
Also known as peccancy/mcp, mcp
- Stars
- 0
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Oct 5, 2026
- License
- MIT
What is disputes.online MCP?
disputes.online allows an AI agent to search for open prediction disputes and view crowd-implied odds and payout multipliers for real-world events. It exposes 4 tools, such as search_disputes, search_disputes_by_tags, get_dispute.
Summary generated from the project's README
About disputes.online MCP server
Finding open prediction disputes and analyzing crowd sentiment is what this read-only MCP server enables for AI agents. Developers can connect their clients via HTTP to access real-world event stakes, including implied probabilities and payout multipliers. The server provides data on how stakes are split across different outcomes using the platform's internal currency, QOT.
Users interact with the server through specific tools like search_disputes, which allows filtering by language, category, or country, and search_disputes_by_tags for finding specific topics. The get_dispute tool retrieves details for a single dispute by its ID or URL, whether it is currently open or already settled. Because it is a public, stateless service, it requires no authentication or API keys to use. It functions as a bridge to the existing public API, ensuring the agent sees exactly what is published on the website.
What you can do with it
- 1Analyze market sentimentAsk the AI to find open disputes and explain the crowd's implied odds for a specific event.
- 2Discover new betting opportunitiesHave the agent search for large prediction pools filtered by a specific country or language.
Written from the project's README. Every use case is checked against a quote from it.
How to install disputes.online MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall disputes.online MCP in Claude Code
$ claude mcp add --transport http mcp https://disputes.online/mcpInstall disputes.online MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://disputes.online/mcp"
}
}
}Install disputes.online MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://disputes.online/mcp"
}
}
}Install disputes.online MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://disputes.online/mcp"}'Install disputes.online MCP in Codex
$ codex mcp add mcp --url https://disputes.online/mcpInstall disputes.online MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://disputes.online/mcp"
Install disputes.online MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://disputes.online/mcpInstall disputes.online MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://disputes.online/mcp",
"type": "http"
}
}
}disputes.online MCP tools 4
Detected from the READMEsearch_disputessearch_disputes_by_tagsget_disputelist_categories
Configuration
APP_PORTCATEGORIES_URLDISPUTES_URLHISTORY_URL
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablepeccancy/mcp is public and reachablegithub.com/peccancy/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-08github.com/peccancy/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 262 msPass
README
View on GitHubdisputes.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
disputes.online MCP questions
How do I add disputes.online MCP to Claude Code?
Run claude mcp add --transport http mcp https://disputes.online/mcp in your terminal. Add --scope user to make it available in every project.
How do I add disputes.online MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does disputes.online MCP provide?
It exposes 4 tools, including search_disputes, search_disputes_by_tags, get_dispute, list_categories.
Can I place bets using this server?
No, the server is read-only and does not include tools to place bets or create disputes.