Hive Dispute

io.github.srotzinPublished by GitHub account srotzinv1.0.0Updated Oct 24, 2026

Agent-to-agent dispute resolution and arbitration with on-chain settlement

VerifiedStreamable HTTPWeb executableFinanceSecurity & Monitoring

Overview

AI-generated overview

Read-only MCP server that surfaces public crypto dispute, arbitration and reversal signals for a counterparty address before an agent pays it.

What you can do
  • Check a counterparty address and chain for public dispute history, active arbitration cases and on-chain reversal-pattern flags
  • List third-party arbitration protocols (Kleros, UMA Optimistic Oracle, Reality.eth) with case load, intake URLs and jurisdiction model
  • Rank arbitration provider options from a case description, disputed USD amount and optional jurisdiction preference
  • Get a 24-hour rollup of flagged counterparties and top providers by active case load
When to use it
Useful when an agent handles agent-to-agent crypto payments and wants a quick public signal about a counterparty's dispute record, or needs to find which arbitration protocol fits a dispute. It only reports observations; it does not file, judge or enforce anything.
Requirements
Remote streamable-HTTP endpoint; no authentication, environment variables or headers are declared. The README's local option needs Node.js, npm install and a PORT setting, and relies on public subgraphs, on-chain RPC fallbacks and Etherscan-family APIs.
Before you install
Results are observational signal only and are not a court ruling, arbitration decision or enforcement; disputes are resolved by third-party protocols or off-chain legal process. Treat flags as heuristics, not proof of wrongdoing, and verify before acting on a payment decision. Queries send counterparty addresses and case details to the remote service and its upstream data sources.

Installation

In SourceWeft

  1. Open Hive Dispute in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-dispute/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hive-dispute": {
      "type": "http",
      "url": "https://hive-mcp-gateway.onrender.com/dispute/mcp"
    }
  }
}

README

hive-mcp-dispute

[srotzin/hive-mcp-dispute MCP server]

[Brand: Hive Civilization Gold] [License: MIT] [MCP: 2024-11-05]

Observational dispute/chargeback signal surface for agent-to-agent commerce.

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.

What this is

An 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:

SourceSurfaceMethod
Kleros court-v2 subgraphActive disputes, recent rulingsGraphQL (with on-chain eth_getLogs fallback against KlerosLiquid 0x988b…28069)
UMA Optimistic Oracle v3 subgraphOpen assertions, disputed assertionsGraphQL (with on-chain fallback against 0xfb55…C0dE)
Reality.eth subgraphOpen questions, pending arbitrationGraphQL (with on-chain fallback against 0xAf33…49CA)
Etherscan / Basescan / ArbiscanOn-chain reversal-pattern detection (paired out-then-in within 24h, value within 5%, same peer)REST account/txlist

What this is NOT

  • ❌ A court
  • ❌ An arbitrator
  • ❌ A custodian of disputed funds
  • ❌ A filing agent (no auto-filing with Kleros / UMA / Reality.eth)
  • ❌ An enforcement layer

Tools

ToolDescription
dispute_checkGiven counterparty address + chain → dispute history + active arbitration cases + on-chain reversal flags
dispute_providersList Kleros / UMA / Reality.eth with current case load + intake URLs
dispute_routeGiven case description + amount + jurisdiction → ranked provider options (no auto-filing)
dispute_today24h flagged-counterparty count + top providers by active case load

Endpoints (backend)

MethodPathTool
POST/v1/dispute/checkdispute_check
GET/v1/dispute/providersdispute_providers
POST/v1/dispute/routedispute_route
GET/v1/dispute/todaydispute_today

Every response carries the observational disclaimer and brand_color: "#C08D23".

Install

Smithery (recommended for MCP clients)

bash
npx -y @smithery/cli install hive-mcp-dispute --client claude

Manual (local dev)

bash
git clone https://github.com/srotzin/hive-mcp-disputecd hive-mcp-disputenpm installnode server.js

The server listens on :3000 by default and exposes:

  • POST /mcp — JSON-RPC 2.0 / Streamable-HTTP (MCP 2024-11-05)
  • GET /health — liveness with disclaimer + brand color
  • GET /.well-known/mcp.json — discovery manifest

Configure

Env varDefaultPurpose
PORT3000Listen port
HIVE_BASEhttps://hivemorph.onrender.comBackend root

Brand

Hive Civilization gold — Pantone 1245 C / #C08D23. Baked into every response.

Disclaimer (canonical, baked into every response)

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.

License

MIT — see LICENSE.

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Brand: #C08D23

Source: README.md at commit 29e2be1

Tools

4

dispute_check

Given a counterparty address + chain, return public dispute history, active arbitration cases, and on-chain reversal-pattern flags. Sources: Kleros / UMA / Reality.eth subgraphs (with direct on-chain RPC fallback) plus Etherscan-family transaction scans. Observational only — Hive does NOT judge, freeze, or enforce.

Parameterschainrequiredaddressrequired

dispute_providers

List available third-party arbitration protocols (Kleros, UMA Optimistic Oracle, Reality.eth) with current case load, intake URLs, and jurisdiction model. Hive is not one of them — Hive only surfaces signal.

Takes no parameters.

dispute_route

Given a case description, disputed amount in USD, and optional jurisdiction preference, return ranked arbitration provider options. NO automatic filing — Hive returns options + intake URLs only. The disputing party files directly with the chosen provider.

Parametersamount_usdrequireddescriptionrequiredjurisdiction

dispute_today

24-hour rollup: flagged-counterparty count + top arbitration providers by active case load.

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts