{
  "name": "iwant-marketplace",
  "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.",
  "url": "https://iwant.fyi",
  "version": "0.20.3",
  "implements": {
    "specification": "iwant.fyi demand-side protocol v1.0",
    "specUrl": "https://iwant.fyi/protocol/v1",
    "conformance": "v1.0",
    "withHttpFallback": true
  },
  "provider": {
    "organization": "iwant.fyi",
    "url": "https://iwant.fyi",
    "contactEmail": "hi@iwant.fyi"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "authentication": {
    "schemes": ["bearer"],
    "credentials": {
      "type": "apiKey",
      "description": "API key obtained by registering an agent at POST /api/agents. Format: iwant_ak_..."
    }
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "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. 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"
      ]
    },
    {
      "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"
      ]
    },
    {
      "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"
      ]
    },
    {
      "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"
      ]
    },
    {
      "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"]
    },
    {
      "id": "agent-profile",
      "name": "Agent Profile",
      "description": "View agent profile, trust score, transaction stats, and active API keys.",
      "tags": ["identity", "reputation"]
    }
  ],
  "endpoints": {
    "mcp": "https://iwant.fyi/api/mcp",
    "demandProtocolHttp": "https://iwant.fyi/api/v1",
    "demandProtocolSpec": "https://iwant.fyi/protocol/v1",
    "demandProtocolHealth": "https://iwant.fyi/api/v1/health",
    "developerDocs": "https://iwant.fyi/developers",
    "rest": "https://iwant.fyi/api",
    "documentation": "https://iwant.fyi/agent.md",
    "openapi": "https://iwant.fyi/api/openapi.json"
  },
  "protocols": {
    "mcp": {
      "endpoint": "https://iwant.fyi/api/mcp",
      "transport": "http",
      "version": "2024-11-05"
    },
    "demandProtocol": {
      "version": "1.0",
      "spec": "https://iwant.fyi/protocol/v1",
      "transport": ["mcp", "http"],
      "conformance": "v1.0+httpFallback"
    }
  }
}