@juny-klave/mcp

MCP server that gives Claude the ability to negotiate prices on your behalf — autonomously, privately, and with cryptographic proof of the outcome.

---

What it does

KLAVE connects Claude to a bilateral negotiation engine. You describe what you want in plain English; Claude calls KLAVE, runs the negotiation through multiple rounds, and reports back with the settled price and a ZK proof reference. Your ceiling is cryptographically bound to the authorization token and never appears in any response — the seller never sees your budget.

---

What You Can Negotiate

Anything with a price. KLAVE does not require pre-existing listings, platform partnerships, or pre-seeded scenarios. If it has an asking price and you have a ceiling, KLAVE can negotiate it.

Freight and logistics
> "Negotiate 200 FEU containers Shanghai to Rotterdam. They're asking $2,806. My ceiling is $2,700."

Software and SaaS
> "Get me a better price on this CRM license. 500 seats, they want $75,000 annually. I won't go above $58,000."

Employment and contracts
> "A contractor is asking $185/hour for a 6-month engagement. My budget is $150/hour. Negotiate it."

Real estate
> "Negotiate our office lease renewal. Landlord wants $42/sqft. We need to be at $35 or below."

Legal and settlement
> "Negotiate a settlement. The other party is asking $250,000. My ceiling is $180,000."

Any bilateral negotiation
> "They're asking [X]. I won't pay more than [Y]. Negotiate."

---

Prerequisites

- Node.js 18+
- Claude Desktop or Claude Code
- A KLAVE API key — get one at klave-platform.vercel.app/docs

---

Install in Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "klave": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://klave1-production.up.railway.app/mcp/sse",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your key from klave-platform.vercel.app/docs.

---

Install in Claude Code

claude mcp add klave \
  --transport sse \
  "https://klave1-production.up.railway.app/mcp/sse" \
  --header "x-api-key:YOUR_API_KEY"

---

Run locally (stdio)

git clone https://github.com/juny-klave/klave-mcp.git
cd klave-mcp
npm install
npm run build

Then point Claude Desktop at the local build:

{
  "mcpServers": {
    "klave": {
      "command": "node",
      "args": ["/absolute/path/to/klave-mcp/dist/index.js"],
      "env": {
        "KLAVE_API_URL": "https://klave1-production.up.railway.app",
        "KLAVE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

---

The 4 tools

| Tool | What it does |
|---|---|
| klave_negotiate | Start a negotiation — any subject, any industry, any price range |
| klave_advance | Advance one round — call in a loop until SETTLED or TERMINATED |
| klave_status | Get current state and full round history at any time |
| klave_verify | Get the ZK proof confirming the settlement was conducted fairly |

Tool sequence

klave_negotiate        ← describe what you're negotiating and your ceiling
klave_advance (loop)   ← advance round by round until SETTLED
klave_status           ← check progress at any time
klave_verify           ← get cryptographic proof after settlement

---

Privacy guarantees

- Your ceiling (ceiling_price) is passed to the negotiation engine and never appears in any tool response.
- The seller's floor price is derived server-side and never a field in any API response.
- leaks_detected in verify responses is sourced from the server — never hardcoded.
- Every negotiation generates an auditable ZK proof.

---

Environment variables (local mode)

| Variable | Default | Description |
|---|---|---|
| KLAVE_API_URL | https://klave1-production.up.railway.app | KLAVE REST API base URL |
| KLAVE_API_KEY | (empty) | API key |
| TRANSPORT | stdio | stdio (Claude Desktop/Code) or http (remote/SSE) |
| PORT | 3002 | HTTP port when TRANSPORT=http |

---

Getting an API key

Sign up at klave-platform.vercel.app/docs.

---

Developer SDK

If you're building an agent that needs to authorize negotiation programmatically, see the KLAVE SDK (@juny-klave/sdk).

---

License

MIT