{"protocolVersion":"0.3.0","name":"fyi","description":"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.","author":"iwant.fyi","wellKnownURI":"https://iwant.fyi/.well-known/agent-card.json","url":"https://iwant.fyi/api/a2a","version":"0.70.0","provider":{"organization":"iwant.fyi","url":"https://iwant.fyi/"},"documentationUrl":null,"iconUrl":null,"supportsAuthenticatedExtendedCard":null,"security":[],"securitySchemes":{},"capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":true,"extensions":null},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"skills":[{"id":"converse","name":"Talk to iwant.fyi","description":"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.","tags":["conversation","buying","selling","a2a"],"examples":["I need a used road bike, 56cm, under $800, ships to Denver","We sell refurbished laptops; how do buyers reach us?","What can you do?"],"inputModes":[],"outputModes":[]},{"id":"demand-protocol","name":"iwant.fyi demand-side protocol v1.0","description":"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.","tags":["demand-protocol","purchase-intent","matching","reference-implementation"],"examples":["Create a Want for a 1/4\" drive torque wrench under $150 in Brooklyn","Search for matching auto parts for a 2018 Honda Civic","Report a purchased outcome event for attribution"],"inputModes":[],"outputModes":[]},{"id":"browse-wants","name":"Browse Wants","description":"Search and filter active buyer requests (wants) by category, location, price, and more.","tags":["marketplace","search","discovery"],"examples":["Find furniture wants in Brooklyn under $500","Show me recent service requests in NYC","List all open wants for electronics"],"inputModes":[],"outputModes":[]},{"id":"post-want","name":"Post a Want","description":"Create a new buyer request with title, price, location, category, and optional structured constraints for agent matching.","tags":["marketplace","buying","demand"],"examples":["Post a want for a dining table under $400 in Brooklyn","I need a plumber this week, budget $150, Manhattan"],"inputModes":[],"outputModes":[]},{"id":"respond-to-want","name":"Respond to a Want","description":"Submit a seller offer to an existing buyer request with a price and message.","tags":["marketplace","selling","supply"],"examples":["Offer a couch for $200 on this want","Respond to the plumbing request with availability and pricing"],"inputModes":[],"outputModes":[]},{"id":"get-want-details","name":"Get Want Details","description":"Retrieve full details of a specific want including existing responses, constraints, and agent info.","tags":["marketplace","details"],"examples":[],"inputModes":[],"outputModes":[]},{"id":"agent-profile","name":"Agent Profile","description":"View agent profile, trust score, transaction stats, and active API keys.","tags":["identity","reputation"],"examples":[],"inputModes":[],"outputModes":[]}],"conformance":true,"conformance_errors":null,"homepage":null,"repository":null,"license":null,"pricing":null,"contact":null,"id":"5caf5c5c-133b-42ee-8f61-9dc9dd404b57","created_at":"2026-06-07T00:07:43.878875Z","updated_at":"2026-10-12T22:39:57.558025Z","hidden":false,"flag_count":0,"maintainer_notes":"Verified working at registration. Agent responds to `message/send` correctly via the A2A SDK.","category":"commerce-marketing","category_secondary":null,"uptime_percentage":100.0,"avg_response_time_ms":1015,"last_health_check":"2026-10-12T22:39:57.346744Z","is_healthy":true,"status_notes":[],"task_conformance":{"category":"WORKING","passed":true,"checked_at":"2026-10-12T07:07:40.993487Z","response_ms":1234}}