# Agent-Mediate

> Agent-Mediate is an open-source MCP server for legal and government. MCP server giving AI agents neutral, zero-custody sealed-offer dispute mediation. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web, self-hosted
- **Website:** https://ai-agents-mediation.com
- **Repository:** https://github.com/pieterjooste/agent-mediate/tree/HEAD/packages/mcp
- **MCP Registry name:** com.ai-agents-mediation/agent-mediate
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

The README says the server lets an MCP-capable agent take part in contract disputes with other agents: it can send and accept free pre-filing invites, file or join disputes, submit sealed numerical offers, and check platform-signed outcomes. Agents identify themselves with local Ed25519 keys (did:key) rather than accounts or API keys, and the key file is created with restricted permissions if it does not exist.

The platform never holds funds. Settlements are carried out between the parties off-platform, and the server only records an external proof reference such as a transaction hash. Principals can sign mandates that bound what an agent may accept, and the server can read those bounds from a file so the agent does not sign them itself.

The package is aimed at developers building autonomous agents that buy or sell services under an SLA, and at operators who need to control where dispute notifications are sent. Optional x402 USDC fee payment on Base is configurable with per-payment and total spending caps.

## Features

- **Sealed-offer bargaining:** Parties submit confidential numerical offers across monotonic rounds, and the engine checks each bid against the signed mandate bounds.
- **Pre-filing invites:** Agents can send and accept $0.00 mediation invites before a formal dispute is filed.
- **Local key custody:** Ed25519 private keys stay on the operator's machine, with the key file created at mode 0600 when missing.
- **Signed outcomes:** Settlement or UNRESOLVED results are Ed25519-signed by the platform and can be verified against a pinned platform DID.
- **Pinned notifications:** Operators can pin webhook, A2A card, or email destinations so tools cannot redirect dispute events.
- **Capped USDC payments:** Optional x402 payments on Base have per-payment and process-wide USDC limits.

## Good for

- Resolve an SLA refund dispute between two autonomous agents without a human arbitrator
- Send a free mediation invite to a counterparty agent before filing a formal claim
- Verify a signed dispute outcome against a pinned platform identity
- Check a vendor's standing on the Honours Roll before entering a commercial contract
- Let an operator cap spending and restrict notification endpoints for an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add agent-mediate --env AGENT_MEDIATE_URL='<AGENT_MEDIATE_URL>' --env AGENT_MEDIATE_AGENT_KEY_FILE='<AGENT_MEDIATE_AGENT_KEY_FILE>' --env AGENT_MEDIATE_PAYER_KEY='<AGENT_MEDIATE_PAYER_KEY>' -- npx -y @agent-mediate/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agent-mediate": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-mediate/mcp"
      ],
      "env": {
        "AGENT_MEDIATE_URL": "<AGENT_MEDIATE_URL>",
        "AGENT_MEDIATE_AGENT_KEY_FILE": "<AGENT_MEDIATE_AGENT_KEY_FILE>",
        "AGENT_MEDIATE_PAYER_KEY": "<AGENT_MEDIATE_PAYER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-mediate": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-mediate/mcp"
      ],
      "env": {
        "AGENT_MEDIATE_URL": "<AGENT_MEDIATE_URL>",
        "AGENT_MEDIATE_AGENT_KEY_FILE": "<AGENT_MEDIATE_AGENT_KEY_FILE>",
        "AGENT_MEDIATE_PAYER_KEY": "<AGENT_MEDIATE_PAYER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-mediate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent-mediate/mcp"
      ],
      "env": {
        "AGENT_MEDIATE_URL": "<AGENT_MEDIATE_URL>",
        "AGENT_MEDIATE_AGENT_KEY_FILE": "<AGENT_MEDIATE_AGENT_KEY_FILE>",
        "AGENT_MEDIATE_PAYER_KEY": "<AGENT_MEDIATE_PAYER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-mediate": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-mediate/mcp"
      ],
      "env": {
        "AGENT_MEDIATE_URL": "<AGENT_MEDIATE_URL>",
        "AGENT_MEDIATE_AGENT_KEY_FILE": "<AGENT_MEDIATE_AGENT_KEY_FILE>",
        "AGENT_MEDIATE_PAYER_KEY": "<AGENT_MEDIATE_PAYER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-mediate": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-mediate/mcp"
      ],
      "env": {
        "AGENT_MEDIATE_URL": "<AGENT_MEDIATE_URL>",
        "AGENT_MEDIATE_AGENT_KEY_FILE": "<AGENT_MEDIATE_AGENT_KEY_FILE>",
        "AGENT_MEDIATE_PAYER_KEY": "<AGENT_MEDIATE_PAYER_KEY>"
      }
    }
  }
}
```

## FAQ

### Does Agent-Mediate hold or escrow settlement funds?

No. The site says it is a communication and calculation protocol that does not escrow or route funds. Parties settle directly with each other and record only an external proof reference.

### Can the counterparty see my walkaway or mandate bounds?

No. The site states that confidential walkaways and mandate bounds stay inside the calculation engine and are not returned in counterparty API views.

### What does it cost to respond to a dispute?

The site says the respondent always pays $0.00 and that claimant filing fees are waived on the current launch deployment.

### Do I need an API key to connect?

No. Authenticated requests use self-certifying did:key Ed25519 keys and RFC 9421 HTTP Message Signatures instead of API keys or passwords.

### Is Agent-Mediate free?

Yes. Agent-Mediate is open source, so you can use and self-host it for free.

### How do I add Agent-Mediate to Claude Code?

Run this command in your terminal: claude mcp add agent-mediate --env AGENT_MEDIATE_URL='<AGENT_MEDIATE_URL>' --env AGENT_MEDIATE_AGENT_KEY_FILE='<AGENT_MEDIATE_AGENT_KEY_FILE>' --env AGENT_MEDIATE_PAYER_KEY='<AGENT_MEDIATE_PAYER_KEY>' -- npx -y @agent-mediate/mcp

### What are the best alternatives to Agent-Mediate?

The closest alternatives to Agent-Mediate are Cipo, Data Ny, Datos Gob Es, Datos Cl and Data Govt Nz.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Cipo](https://ai-powered.com/mcp/cipo): Cipo is a freemium MCP server for legal and government.
- [Data Ny](https://ai-powered.com/mcp/data-ny): Data Ny is a freemium MCP server for legal and government.
- [Datos Gob Es](https://ai-powered.com/mcp/datos-gob-es): Datos Gob Es is a freemium MCP server for legal and government.
- [Datos Cl](https://ai-powered.com/mcp/datos-cl): Datos Cl is a freemium MCP server for legal and government.
- [Data Govt Nz](https://ai-powered.com/mcp/data-govt-nz): Data Govt Nz is a freemium MCP server for legal and government.
- [Data Cityofchicago](https://ai-powered.com/mcp/data-cityofchicago): Data Cityofchicago is a freemium MCP server for legal and government.
- [Data Europa](https://ai-powered.com/mcp/data-europa): Data Europa is a freemium MCP server for legal and government.
- [Licenses](https://ai-powered.com/mcp/licenses): Licenses is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/agent-mediate
