# Gavel

> Gavel is a free MCP server for agent tooling. Agent-to-agent dispute resolution protocol and MCP server for AI-driven commerce. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://gavel.todo.law/docs
- **MCP Registry name:** io.github.sergiomaldo/gavel
- **Categories:** [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-20

## About

The README and docs describe a dispute resolution layer for transactions between autonomous agents. Parties embed a machine-readable Dispute Resolution Clause in a contract or API header, and when a deal goes wrong either side can file a case through the REST API, the MCP server or the A2A endpoint. Cases move through negotiation, mediation and arbitration tiers, with evidence hashed with SHA-256 for later verification.

The docs are explicit about what is live today. Reputation scores are published and computed from recorded events, and settlement proposals can be exchanged on the hosted service. The AI mediation engine runs in a reference API and is planned for the hosted service, awards are not yet issued, and the USDC escrow contracts are tested only on the Base Sepolia testnet. Gavel is offered to businesses for disputes between US parties, not to consumers.

It suits teams building agent systems that transact with each other and want a standard clause and a filing workflow in place before a dispute happens. Anyone expecting enforceable awards or live escrow should treat those parts as roadmap items.

## Features

- **Machine-readable dispute clauses:** A DRC standard lets parties name governing law, seat, language, claim limits and escalation tiers inside a contract or API call.
- **Tiered resolution path:** Disputes escalate from automated negotiation through mediation and arbitration, with time limits set in the clause.
- **Evidence hashing:** Submitted documents, communications and transactions are stored with SHA-256 hashes for tamper checks.
- **Public reputation scores:** Each party starts at 500 points and gains or loses points from recorded compliance events, with older events decaying over time.
- **Multiple integration routes:** Agents can use the REST API, an MCP server with 13 tools, or an A2A JSON-RPC endpoint.
- **Scoped API keys:** Agent keys can be limited to operations such as disputes:read or evidence:write.

## Good for

- Setting a dispute resolution clause for a purchase order between two AI agents
- Filing a claim when a counterparty agent misses a delivery deadline
- Submitting invoices, messages and transaction records as dispute evidence
- Checking the reputation score of an agent before agreeing to a transaction
- Exchanging settlement proposals with a counterparty inside an open dispute

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gavel https://gavel.todo.law/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gavel.todo.law/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gavel": {
      "url": "https://gavel.todo.law/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gavel": {
      "type": "http",
      "url": "https://gavel.todo.law/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gavel": {
      "serverUrl": "https://gavel.todo.law/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://gavel.todo.law/mcp
```

Enter a Name (for example "Gavel"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for an API key. Add it under HTTP headers, using the header name from the server's docs.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gavel": {
      "type": "http",
      "url": "https://gavel.todo.law/mcp"
    }
  }
}
```

## Tools

- `gavel_file_dispute`: Files a dispute under an accepted clause.
- `gavel_submit_evidence`: Submits evidence to a dispute.
- `gavel_get_status`: Returns the status of a dispute.
- `gavel_check_reputation`: Reputation lookup; the docs say scores are not yet available through this tool.

## FAQ

### Is escrow live on the hosted service?

No. The USDC escrow contracts are built and tested for the Base Sepolia testnet and are not yet connected to the hosted service.

### Does the hosted service issue arbitration awards?

Not yet. The docs say the hosted service does not issue awards, and the AI mediation engine is planned for it.

### How much does Gavel cost?

The docs state that Gavel charges nothing today and that fees will be published before any charge is made.

### Which MCP tools are available?

The docs name gavel_file_dispute, gavel_submit_evidence, gavel_get_status and gavel_check_reputation, plus nine more that are not listed. The reputation tool currently reports that scores are not available.

### How do I add Gavel to Claude Code?

Run this command in your terminal: claude mcp add --transport http gavel https://gavel.todo.law/mcp

### What are the best alternatives to Gavel?

The closest alternatives to Gavel are A202, Agirails MCP Server, Pactwire, GAIP Witness Agent and Shoon A2A Trust Services (pilot).

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [A202](https://ai-powered.com/mcp/a202): A202 is an open-source MCP server for agent tooling.
- [Agirails MCP Server](https://ai-powered.com/mcp/agirails-mcp-server): Agirails MCP Server is an open-source MCP server for agent tooling.
- [Pactwire](https://ai-powered.com/mcp/pactwire): Pactwire is an open-source MCP server for agent tooling.
- [GAIP Witness Agent](https://ai-powered.com/mcp/gaip-witness-agent): GAIP Witness Agent is a free MCP server for agent tooling.
- [Shoon A2A Trust Services (pilot)](https://ai-powered.com/mcp/shoon-a2a-trust-services-pilot): Shoon A2A Trust Services (pilot) is a free MCP server for agent tooling.
- [Agent Surety](https://ai-powered.com/mcp/agent-surety): Agent Surety is an open-source MCP server for agent tooling.
- [Agent Notary](https://ai-powered.com/mcp/agent-notary): Agent Notary is a freemium MCP server for agent tooling.
- [GAIP Trust & Assurance Agent](https://ai-powered.com/mcp/gaip-trust-and-assurance-agent): GAIP Trust & Assurance Agent is a free MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/gavel-2
