disputes.online

disputes.online MCP 服务

一个面向 disputes.online 的公开只读 Model Context Protocol 服务。它让 AI Agent 能够查找尚未结束的争议，并查看各方对这些争议的投注金额如何分配——也就是群体隐含的赔率。

端点： https://disputes.online/mcp（Streamable HTTP，无需身份验证）

工具

工具	功能
search_disputes	查找开放投注的争议，可按语言、类别和国家筛选，并按资金池规模、投注数量或截止时间排序
search_disputes_by_tags	查找带有任意指定标签的未结束争议
get_dispute	按 ID 或页面 URL 获取单个争议，包括未结束的争议，或已结算且包含获胜结果的争议
list_categories	获取类别树，以便查找 category_id

每项争议都附有其页面 URL，以及各结果对应的投注金额占比（implied_probability）和赔付倍数。金额以 QOT 计，这是平台的内部货币。列表默认使用英语；如需查找以其他语言撰写的争议，请传入 lang。

没有任何工具可以下注、创建争议或代用户执行操作。

连接

Claude Code：

claude mcp add --transport http disputes-online https://disputes.online/mcp

适用于接受 JSON 配置的任意客户端：

{ "mcpServers": { "disputes-online": { "type": "http", "url": "https://disputes.online/mcp" } } }

工作原理

该服务无法访问数据库。它会调用网站使用的同一个公共 API （https://disputes.online/openapi.json），因此只能提供网站已公开的信息。 它是无状态的：任何副本都可以响应任何请求。

配置

变量	默认值	含义
APP_PORT	8098	监听端口
API_PATH	/mcp	提供协议服务的路径
DISPUTES_URL	http://disputes:8080	争议服务的基础 URL
CATEGORIES_URL	http://categories:8082	类别服务的基础 URL
HISTORY_URL	http://history:8095	历史服务的基础 URL（已结算的争议）
PLATFORM_TIMEOUT	5s	调用任一服务的单次超时时间
RATE_LIMIT_RPS / RATE_LIMIT_BURST	20 / 40	总请求速率限制

GET /health 会返回 ok。

本地运行

APP_PORT=8098 \
DISPUTES_URL=https://disputes.online/disputes \
CATEGORIES_URL=https://disputes.online/category \
HISTORY_URL=https://disputes.online/history \
go run ./cmd

然后将客户端或 npx @modelcontextprotocol/inspector 指向 http://localhost:8098/mcp。

发布到 MCP 注册表

server.json 描述了此服务在官方 MCP 注册表中的信息，名称为 online.disputes/mcp。该命名空间归控制 disputes.online 的一方所有：网站在 https://disputes.online/.well-known/mcp-registry-auth 提供公钥，发布时需要与之匹配的私钥。该私钥保存在本仓库之外的 ~/.mcp-registry/disputes.online.pem。

brew install mcp-publisher
./publish.sh

再次发布前，请更新 server.json 中的 version；注册表不接受已存在的版本。

测试

go test ./...

许可证

MIT