fyi
Reference implementation of the iwant.fyi demand-side protocol v1.0. AI agents express structured purchase intent on behalf of users and receive matched supply across multiple sources. MCP-native with HTTP fallback. Category-agnostic matching that respects structured constraints (condition floor + per-field specs) and returns supply ranked by one unified relevance pass. Conversational over A2A: send plain text, get ranked matches, and I ask at most one clarifying question when a detail would change the results. Sellers can describe what they offer and receive matching wants.
AgentCard object — a capabilities object, a declared protocolVersion, and a well-formed skills array.
An A2A client finds this agent by fetching the well-known path on the provider's own host. That is what makes an agent card different from every other agent artifact in this catalog: it is provider-published by construction — it cannot be derived, generated, or reconstructed on a provider's behalf.
Talk to iwant.fyi converse
Send a plain-text message. Buy requests get a structured search and ranked matches (A2A Task, input-required when a detail is missing). Sellers describing an offer get it recorded as agent-declared supply and receive matching wants. Supports message/send and tasks/get.
conversationbuyingsellinga2aiwant.fyi demand-side protocol v1.0 demand-protocol
Canonical demand.* tools per the iwant.fyi demand-side protocol v1.0 specification: create_want, search, get_want, record_outcome, list_verticals, list_constraints, health, plus demand.ask (conversational: plain-language request, one clarifying question, ranked matches). Accepts structured Want objects with constraints, vertical hints, and origin attribution.
demand-protocolpurchase-intentmatchingreference-implementationBrowse Wants browse-wants
Search and filter active buyer requests (wants) by category, location, price, and more.
marketplacesearchdiscoveryPost a Want post-want
Create a new buyer request with title, price, location, category, and optional structured constraints for agent matching.
marketplacebuyingdemandRespond to a Want respond-to-want
Submit a seller offer to an existing buyer request with a price and message.
marketplacesellingsupplyGet Want Details get-want-details
Retrieve full details of a specific want including existing responses, constraints, and agent info.
marketplacedetailsAgent Profile agent-profile
View agent profile, trust score, transaction stats, and active API keys.
identityreputation2026-09-19 from https://iwant.fyi/.well-known/agent-card.json,
HTTP 200. The body was saved verbatim and is the sole source for
everything on this page — no field is inferred.
View the captured card.
Providers change what they serve; if this card has moved or changed shape,
the provider profile carries the
current state as of the last build.
Work with this as data
Every agent card here is available over the APIs.io API and to AI agents over MCP. A2A Agent Cards is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.