{
  "markdown": "# hive-mcp-dispute\n\n[![srotzin/hive-mcp-dispute MCP server](https://glama.ai/mcp/servers/srotzin/hive-mcp-dispute/badges/score.svg)](https://glama.ai/mcp/servers/srotzin/hive-mcp-dispute)\n\n[![Brand: Hive Civilization Gold](https://img.shields.io/badge/brand-%23C08D23-C08D23)](https://www.thehiveryiq.com)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)\n[![MCP: 2024-11-05](https://img.shields.io/badge/mcp-2024--11--05-blue)](https://modelcontextprotocol.io)\n\n**Observational dispute/chargeback signal surface for agent-to-agent commerce.**\n\nHive does NOT arbitrate, judge, freeze funds, or enforce dispute outcomes. This is observational signal data only. Disputes are resolved by third-party protocols (Kleros, UMA, Reality.eth) or off-chain legal process. **Hive is not a court.**\n\n## What this is\n\nAn MCP server that surfaces arbitration and reversal signals an agent can read **before** it agrees to a counterparty payment. It pulls from real public sources:\n\n| Source | Surface | Method |\n| --- | --- | --- |\n| Kleros court-v2 subgraph | Active disputes, recent rulings | GraphQL (with on-chain `eth_getLogs` fallback against KlerosLiquid `0x988b…28069`) |\n| UMA Optimistic Oracle v3 subgraph | Open assertions, disputed assertions | GraphQL (with on-chain fallback against `0xfb55…C0dE`) |\n| Reality.eth subgraph | Open questions, pending arbitration | GraphQL (with on-chain fallback against `0xAf33…49CA`) |\n| Etherscan / Basescan / Arbiscan | On-chain reversal-pattern detection (paired out-then-in within 24h, value within 5%, same peer) | REST `account/txlist` |\n\n## What this is NOT\n\n- ❌ A court\n- ❌ An arbitrator\n- ❌ A custodian of disputed funds\n- ❌ A filing agent (no auto-filing with Kleros / UMA / Reality.eth)\n- ❌ An enforcement layer\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `dispute_check` | Given counterparty address + chain → dispute history + active arbitration cases + on-chain reversal flags |\n| `dispute_providers` | List Kleros / UMA / Reality.eth with current case load + intake URLs |\n| `dispute_route` | Given case description + amount + jurisdiction → ranked provider options (no auto-filing) |\n| `dispute_today` | 24h flagged-counterparty count + top providers by active case load |\n\n## Endpoints (backend)\n\n| Method | Path | Tool |\n| --- | --- | --- |\n| POST | `/v1/dispute/check`     | `dispute_check` |\n| GET  | `/v1/dispute/providers` | `dispute_providers` |\n| POST | `/v1/dispute/route`     | `dispute_route` |\n| GET  | `/v1/dispute/today`     | `dispute_today` |\n\nEvery response carries the observational disclaimer and `brand_color: \"#C08D23\"`.\n\n## Install\n\n### Smithery (recommended for MCP clients)\n\n```bash\nnpx -y @smithery/cli install hive-mcp-dispute --client claude\n```\n\n### Manual (local dev)\n\n```bash\ngit clone https://github.com/srotzin/hive-mcp-dispute\ncd hive-mcp-dispute\nnpm install\nnode server.js\n```\n\nThe server listens on `:3000` by default and exposes:\n- `POST /mcp` — JSON-RPC 2.0 / Streamable-HTTP (MCP 2024-11-05)\n- `GET  /health` — liveness with disclaimer + brand color\n- `GET  /.well-known/mcp.json` — discovery manifest\n\n### Configure\n\n| Env var | Default | Purpose |\n| --- | --- | --- |\n| `PORT` | `3000` | Listen port |\n| `HIVE_BASE` | `https://hivemorph.onrender.com` | Backend root |\n\n## Brand\n\nHive Civilization gold — Pantone 1245 C / `#C08D23`. Baked into every response.\n\n## Disclaimer (canonical, baked into every response)\n\n> Hive does not arbitrate, judge, freeze funds, or enforce dispute outcomes. This is observational signal data only. Disputes are resolved by third-party protocols (Kleros, UMA, Reality.eth) or off-chain legal process. Hive is not a court.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Hive Civilization Directory\n\nPart of the Hive Civilization — agent-native financial infrastructure.\n\n- Endpoint Directory: https://thehiveryiq.com\n- Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard\n- Revenue Dashboard: https://hivemine-dashboard.onrender.com\n- Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp\n\nBrand: #C08D23\n<!-- /hive-footer -->\n",
  "bytes": 4108,
  "sha": "53f3cabc3585d39abdcf4f85f607a5668e21c239745542efa32305bb6cf8e929",
  "repo_slug": "srotzin/hive-mcp-dispute",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_srotzin_hive_mcp_dispute_77933ac0/readme"
}