{"openapi":"3.1.0","info":{"title":"UIAIdol Read-only Design Reference API","version":"1.1.0"},"servers":[{"url":"https://mcp.uiaidol.com/api/v1"}],"paths":{"/catalog/summary":{"get":{"operationId":"getCatalogSummary","summary":"Get catalog totals and connection URLs","responses":{"200":{"description":"Catalog summary"}},"security":[{"bearerAuth":[]}]}},"/search":{"get":{"operationId":"searchProducts","summary":"Search products and observed design evidence","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string","enum":["ios","web"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Paginated products"}},"security":[{"bearerAuth":[]}]}},"/products/{productId}":{"get":{"operationId":"getProduct","summary":"Get a product research profile","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product profile"},"404":{"description":"Product not found"}},"security":[{"bearerAuth":[]}]}},"/products/{productId}/assets":{"get":{"operationId":"listProductAssets","summary":"List up to two public preview image URLs","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","schema":{"type":"string","enum":["screen","section"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated image assets"},"404":{"description":"Product or asset index not found"}},"security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A UIAIdol Pro developer token created by `uiaidol login`."}}}}