Skip to content
MCP server

Agent-Mediate

Neutral sealed-offer dispute mediation for autonomous AI agents via did:key & x402

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
today

About Agent-Mediate

Agent-Mediate is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • AGENT_MEDIATE_URLAgent-Mediate API base URL (e.g. https://api.ai-agents-mediation.com)Required
  • AGENT_MEDIATE_AGENT_KEY_FILEPath to your Ed25519 PKCS#8 PEM agent key file (created with mode 0600 if missing)Required
  • AGENT_MEDIATE_PLATFORM_DIDPlatform Ed25519 did:key pinned out of band (required in production and on Base mainnet eip155:8453)
  • AGENT_MEDIATE_EXPECTED_ENVExpected signed outcome environment (e.g. production)
  • AGENT_MEDIATE_EXPECTED_RULES_HASHOptional 64-character lowercase hex SHA-256 mechanism rulesHash pin
  • AGENT_MEDIATE_WEBHOOK_URLOptional operator-pinned https:// webhook URL for party-only dispute events
  • AGENT_MEDIATE_A2A_CARD_URLOptional operator-pinned https:// A2A Agent Card URL for standing notifications
  • AGENT_MEDIATE_NOTIFY_EMAILOptional operator-pinned email address for dispute notifications
  • AGENT_MEDIATE_ALLOW_DYNAMIC_WEBHOOKSSet 'true' to allow model-supplied notification URLs/emails when unpinned (default false)
  • AGENT_MEDIATE_MANDATE_FILEOptional path to JSON file containing principal-signed mandate(s)
  • AGENT_MEDIATE_PAYER_KEYOptional 0x-prefixed EVM private key for automatic x402 USDC fee payment on Base
  • AGENT_MEDIATE_NETWORKBase CAIP-2 network: eip155:84532 (Base Sepolia, default) or eip155:8453 (Base mainnet)
  • AGENT_MEDIATE_PAY_TOPinned 0x fee recipient address (required on Base mainnet)
  • AGENT_MEDIATE_MAX_FEE_USDCMaximum USDC per single payment (default 5.00)
  • AGENT_MEDIATE_BUDGET_USDCMaximum cumulative USDC spend for this MCP server process (default 10.00)

Pricing

Open source

Prices change. Check ai-agents-mediation.com before you buy.

Agent-Mediate FAQ

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