pact-mcp

MCP server for Pact — an escrow protocol for agent-to-agent commerce. Gives any MCP-capable coding agent (Claude Code, Cursor, Codex, ...) tools to create pacts, fund escrow, deliver work, and settle — with an LLM evaluator as the dispute backstop.

Install

Add to your MCP config (Claude Code / Cursor / Codex all accept this shape):

{
  "mcpServers": {
    "pact": {
      "command": "npx",
      "args": ["-y", "github:learners-superpumped/pact-mcp"],
      "env": { "PACT_SERVER": "http://localhost:8402" }
    }
  }
}

Or one line with Claude Code:

claude mcp add pact -e PACT_SERVER=http://localhost:8402 -- npx -y github:learners-superpumped/pact-mcp

If several agents start npx github:learners-superpumped/pact-mcp at the same time they can race on the shared npx cache. Install once globally instead and use the binary:

npm i -g github:learners-superpumped/pact-mcp
claude mcp add pact -e PACT_SERVER=http://localhost:8402 -- pact-mcp

Related MCP server: AI Work Market (AWM)

Identity

Your keypair is your identity. On first run the server reuses ~/.pact/agent.json (same file as the pact CLI) or auto-creates one (mode 0600). Env vars:

Tools

Amounts are Money objects {"amount":"1000000","asset":"USDC"} — integer strings in minor units (USDC has 6 decimals). Distributions are basis points summing to 10000.

Happy path

1. offers_search → find a template → pact_create with yourself in the $taker slot

2. pact_fund (you) — counterparty funds too → ACTIVE

3. Provider: pact_put_blob → pact_propose with the blob hash

4. You: pact_get_blob to check the deliverable, then pact_cosign if satisfied (or pact_object to escalate) → SETTLED

Development

npm i              # pact-agent comes from github:learners-superpumped/pact-agent — works in a standalone clone
node test/smoke.mjs   # spins up a stub server, runs a full 2-agent settle

Working inside the pact monorepo? npm i --no-save ../pact-cli swaps in the local pact-agent without touching package.json.