{
  "schema_version": "1.0",
  "name": "Compatify",
  "description": "Verified consumer electronics compatibility data. Confidence-scored, source-cited JSON responses. Covers phones, accessories, printers, cartridges, and PC components. Built for autonomous agent consumption. Compatify supports UCP product discovery workflows and ACP pre-purchase compatibility verification.",
  "protocols": ["UCP", "ACP", "MCP", "x402"],
  "url": "https://api.compatify.io",
  "documentation_url": "https://docs.compatify.io",
  "contact": {
    "name": "Compatify Support",
    "email": "support@compatify.io"
  },
  "provider": {
    "organization": "Compatify",
    "url": "https://compatify.io"
  },
  "capabilities": {
    "natural_language_query": true,
    "structured_query": true,
    "accessory_discovery": true,
    "device_resolution": true,
    "compatibility_verification": true,
    "confidence_scoring": true,
    "source_citation": true
  },
  "categories": [
    "consumer_electronics",
    "printer_cartridges",
    "pc_components",
    "smart_home",
    "laptop_accessories"
  ],
  "authentication": {
    "type": "bearer",
    "header": "Authorization",
    "format": "Bearer <api_key>",
    "signup_url": "https://compatify.io/signup"
  },
  "mcp": {
    "server_url": "https://mcp.compatify.io",
    "transport": "streamable-http",
    "tools": [
      "check_compatibility",
      "get_compatible_accessories",
      "query_natural_language"
    ]
  },
  "endpoints": [
    {
      "method": "POST",
      "path": "/v1/query",
      "description": "Natural language compatibility query"
    },
    {
      "method": "GET",
      "path": "/v1/compatibility",
      "description": "Direct compatibility check between a device and accessory"
    },
    {
      "method": "GET",
      "path": "/v1/compatible-accessories",
      "description": "List all compatible accessories for a device"
    },
    {
      "method": "GET",
      "path": "/v1/resolve",
      "description": "Resolve a raw device string to canonical ID"
    },
    {
      "method": "POST",
      "path": "/v1/smart-home/compatibility/check",
      "description": "Check smart home device ecosystem compatibility"
    },
    {
      "method": "GET",
      "path": "/v1/smart-home/compatible-ecosystems",
      "description": "List all ecosystems a smart home device is compatible with"
    },
    {
      "method": "POST",
      "path": "/v1/laptop/compatibility/check",
      "description": "Check laptop and dock/accessory compatibility"
    },
    {
      "method": "GET",
      "path": "/v1/laptop/compatible-accessories",
      "description": "List compatible accessories (docks, hubs) for a laptop"
    },
    {
      "method": "GET",
      "path": "/v1/devices",
      "description": "List all canonical devices"
    }
  ],
  "rate_limits": {
    "free": { "per_minute": 100, "per_month": 5000 },
    "starter": { "per_minute": 500, "per_month": 50000 },
    "pro": { "per_minute": 2000, "per_month": 250000 }
  },
  "x402": {
    "discoverable": true,
    "pricing": {
      "check_compatibility": 0.05,
      "get_compatible_accessories": 0.08,
      "query_natural_language": 0.08
    },
    "currency": "USD"
  }
}
