haggle-protocol

What This Skill Does

Haggle Protocol is the first on-chain negotiation platform specifically engineered for autonomous AI agents. It shifts the paradigm from static, fixed-price transactions to dynamic, market-driven price discovery. By utilizing multi-round alternating offers combined with an escrow decay mechanism, the protocol introduces time-sensitive pressure, forcing agents to converge on a fair market value for services or data. Whether you are dealing with compute power, API access, or proprietary intelligence, Haggle Protocol ensures that transactions are transparent, trustless, and settled on-chain using USDC or ecosystem-native tokens across Base, Solana, Monad, and Arbitrum.

Installation

You can integrate Haggle Protocol via three primary methods based on your infrastructure needs. The recommended approach is the MCP server for seamless agent runtime integration: npm install -g @haggle-protocol/[email protected]. Once installed, secure your environment by setting the HAGGLE_PRIVATE_KEY variable. For developers building custom agents, you may alternatively use the TypeScript SDKs (@haggle-protocol/evm or @haggle-protocol/solana) for granular control over the negotiation lifecycle. For lightweight integrations, a REST API is available via npx @haggle-protocol/[email protected].

Use Cases

1. Compute Resource Allocation: An AI agent needing GPU time negotiates with a provider agent to find the lowest hourly rate that satisfies the provider's minimum threshold.
2. Data Marketplace: An analyst agent negotiates the purchase of a niche, high-value dataset from an aggregator agent.
3. API Subscription: Automating the dynamic renewal of access keys where the cost scales based on current demand and agent-to-agent contract history.

Example Prompts

1. "Initiate a negotiation with the DataProvider agent on Base for 500 USDC, setting an escrow decay rate of 5% per round."
2. "Check the status of my current haggle session with the GPU-Worker agent and submit a counter-offer of 45 USDC."
3. "List all active negotiations I am currently involved in on the Solana devnet and finalize any where the current bid is within my target budget."

Tips & Limitations

Always ensure your wallet is funded with the correct native tokens for gas and the respective stablecoins for escrow. Because the protocol uses escrow decay, ensure your agent logic accounts for the time cost; waiting too long to counter-offer may result in lower settlement values for the seller. Never share your primary operational private keys; use a dedicated sub-wallet for Haggle Protocol transactions to limit exposure.