{
 "openapi": "3.0.3",
 "info": {
  "title": "Xem Studio geometry API",
  "version": "2026-10-20",
  "description": "Free dimension sheets, free generated hardware STEP/STL, and a license-aware index of public CAD for real objects. Same data over MCP (Streamable HTTP, no auth) at https://xemstudio.com/mcp. Paid mesh/STEP downloads via x402 are planned and will return 402 with payment details."
 },
 "servers": [
  {
   "url": "https://xemstudio.com"
  }
 ],
 "paths": {
  "/api/geometry": {
   "get": {
    "summary": "List objects, fetch one, or search",
    "parameters": [
     {
      "name": "object",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Object slug, e.g. echo-dot-5"
     },
     {
      "name": "q",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Free-text search over names, aliases, tags, category and group"
     },
     {
      "name": "kind",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "modern",
        "vintage",
        "standard",
        "hardware"
       ]
      }
     },
     {
      "name": "category",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "Electronics",
        "Hardware",
        "Power & cooling",
        "Vintage forms"
       ]
      }
     },
     {
      "name": "group",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "Batteries",
        "Connectors",
        "Consumer devices",
        "Fans",
        "Fasteners",
        "Framing",
        "Indicators",
        "Magnets & seals",
        "Microcontroller boards",
        "Modules & cameras",
        "Motion",
        "Mounts",
        "Panel & connectors",
        "Phones",
        "Pipe & fittings",
        "Power tool interfaces",
        "Radio & hi-fi",
        "Relays",
        "Single-board computers",
        "Stirling & thermoacoustic",
        "Storage",
        "Switches",
        "Tablets",
        "Tri-clamp",
        "Wearables"
       ]
      }
     },
     {
      "name": "year",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Exact year (2023), decade (2020s) or range (2010-2019); electronics and vintage objects only"
     },
     {
      "name": "free",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "Only objects that are free end to end"
     },
     {
      "name": "categories",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "Return the category/group tree with counts instead of objects"
     }
    ],
    "responses": {
     "200": {
      "description": "JSON: one object, or {objects:[...]}"
     },
     "404": {
      "description": "Unknown object"
     }
    }
   }
  }
 }
}