This is the reference server for a new demand-side commerce protocol that lets agents post structured purchase intent and get back ranked matches from multiple suppliers. It exposes tools to create and manage "wants" (one-time or standing), fetch ranked match results, and report outcomes. Unlike supply-side protocols (ACP, UCP) that handle checkout flows, this sits upstream: you express what your user needs, the server coordinates matching and fulfillment across sources, and you get back actionable offers. Ships with a conformance test kit, JSON schemas at a well-known URL, and SDKs for TypeScript, LangChain, Composio, and CrewAI. Reach for it when you're building shopping or procurement agents that need to aggregate supply without hardcoding merchant integrations.
The iwant.fyi demand-side protocol defines how AI agents express structured purchase intent on behalf of users, receive matched supply across multiple sources, and report outcomes back. It is MCP-native, transport-flexible, and intentionally agnostic about who matches the demand, who fulfills it, and how money moves.
Existing agentic commerce protocols are supply-side: ACP and UCP define how an agent completes a purchase at a merchant; AP2 handles payment authorization; MCP is general tool/data access. None of them defines how an agent expresses what its user wants in a structured, machine-matchable form, or how that demand persists across sessions and gets fulfilled across multiple sources.
The iwant.fyi demand-side protocol fills that gap.
Read it rendered with anchors at iwant.fyi/protocol/v1.
JSON Schema for the core objects: schemas/1.1/ (also served live at
https://iwant.fyi/.well-known/iwantfyi/schemas/1.1/).
A test kit verifies any implementation against spec §15:
npx @iwantfyi/conformance-kit --mcp https://iwant.fyi/api/mcp --http https://iwant.fyi/api/v1 --api-key <key>
Source: conformance-kit/ · npm: @iwantfyi/conformance-kit (Apache-2.0). The
reference implementation also self-reports at /api/v1/conformance.
iwant.fyi — https://iwant.fyi/api/mcp
The iwant.fyi MCP server is the reference implementation. It advertises spec conformance and is the canonical surface to test against.
| Framework | Package | Repo |
|---|---|---|
| TypeScript / generic | @iwantfyi/sdk | staugs/iwantfyi-sdk |
| LangChain (Python) | iwantfyi-langchain | staugs/iwantfyi-langchain |
| Composio (Python) | iwantfyi-composio | staugs/iwantfyi-composio |
| CrewAI (Python) | iwantfyi-crewai | staugs/iwantfyi-crewai |
Three open-source example agents at staugs/iwantfyi-examples.
v1.1 is published as a draft for public comment. Feedback, issues, and proposed extensions are welcome via GitHub issues or directly to hi@iwant.fyi.
The specification is published under the Apache License 2.0. Implementations are not required to be open source.
io.github.shelvick/shopify-subscription-reconciliation
csoai-org/meok-stripe-acp-checkout-mcp
csoai-org/stripe-billing-mcp
ai.adramp/google-ads
co.pipeboard/google-ads-mcp
co.curie/commerce