fyi

{
  "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"
}