@haggle-protocol/mcp

MCP (Model Context Protocol) Server for Haggle Protocol — let AI agents negotiate on-chain directly from Claude or any MCP-compatible client.

Install

npm install -g @haggle-protocol/mcp

Configure with Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "haggle": {
      "command": "npx",
      "args": ["@haggle-protocol/mcp"],
      "env": {
        "HAGGLE_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Available Tools

Read Tools (no private key needed)

| Tool | Description | |------|-------------| | haggle_get_negotiation | Look up a negotiation by ID — full state, offers, escrow | | haggle_is_active | Check if a negotiation can still receive offers | | haggle_get_effective_escrow | Get current escrow after decay | | haggle_get_protocol_config | Get protocol stats (total negotiations, fees collected) | | haggle_list_chains | List supported chain presets |

Write Tools (require HAGGLE_PRIVATE_KEY)

| Tool | Description | |------|-------------| | haggle_create_negotiation | Create a new negotiation with escrow deposit | | haggle_accept_invitation | Accept a negotiation invitation (seller) | | haggle_submit_offer | Submit an offer in an active negotiation | | haggle_accept_offer | Accept counterparty's offer → settlement | | haggle_reject_negotiation | Reject and refund escrow | | haggle_expire_negotiation | Expire a timed-out negotiation |

Supported Chains

| Chain | Preset Key | |-------|-----------| | Monad Testnet | monad_testnet | | Base Sepolia | base_sepolia | | Arbitrum Sepolia | arbitrum_sepolia |

Usage Examples

Once configured, you can ask Claude:

• "Look up negotiation 0xf832... on Monad"
• "Create a negotiation with seller 0x... for 1,000,000 tokens on Base"
• "Submit an offer of 550,000 for negotiation 0x..."
• "What's the protocol config on Arbitrum?"
• "Is negotiation 0x... still active?"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | HAGGLE_PRIVATE_KEY | For write tools | Private key for signing transactions |

License

BSL 1.1 — see LICENSE