{"openapi":"3.1.0","info":{"title":"KLIC Registry Read API","version":"1.0.0","description":"Public JSON registry and validated server search. MCP is authenticated by Sites. No server write endpoints."},"servers":[{"url":"https://design.klic.co.kr"}],"paths":{"https://design.klic.co.kr/api/v1/search":{"get":{"operationId":"searchItems","summary":"Search ready or planned catalog items","parameters":[{"name":"query","in":"query","schema":{"type":"string","maxLength":200}},{"name":"kind","in":"query","schema":{"enum":["all","component","block"]}},{"name":"status","in":"query","schema":{"enum":["ready","planned","all"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"token","in":"query","schema":{"type":"string","maxLength":200}},{"name":"group","in":"query","schema":{"type":"string","maxLength":100}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^\\d{1,7}$"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"/klic-interface-library-pages/api/v1/design-system.json":{"get":{"operationId":"getDesignSystem","summary":"Versioned KLIC design rules shared by API, CLI and MCP","responses":{"200":{"description":"Versioned KLIC design rules shared by API, CLI and MCP","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","release","designSystem"],"properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"https://design.klic.co.kr/api/v1/health":{"get":{"operationId":"getHealth","summary":"Registry service status","responses":{"200":{"description":"Registry service status","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"/klic-interface-library-pages/api/v1/registry.json":{"get":{"operationId":"getRegistry","summary":"All component and block entries with explicit ready/planned status","responses":{"200":{"description":"All component and block entries with explicit ready/planned status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Registry"}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"/klic-interface-library-pages/api/v1/capabilities.json":{"get":{"operationId":"getCapabilities","summary":"Integration status, counts and compatibility policy","responses":{"200":{"description":"Integration status, counts and compatibility policy","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"/klic-interface-library-pages/api/v1/tools.json":{"get":{"operationId":"getToolSchemas","summary":"Shared tool definitions","responses":{"200":{"description":"Shared tool definitions","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"https://design.klic.co.kr/api/v1/items/{kind}/{id}.json":{"get":{"operationId":"getItem","summary":"One existing catalog entry","parameters":[{"name":"kind","in":"path","required":true,"schema":{"enum":["component","block"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,90}$"}}],"responses":{"200":{"description":"Item","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"},"schemaVersion":{"const":"1.0"},"release":{"type":"string"},"item":{"$ref":"#/components/schemas/Item"}}}}}},"404":{"description":"Hosting-level missing static resource; JSON error body is not guaranteed. Validate Content-Type and item identity."},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"/klic-interface-library-pages/api/v1/themes.json":{"get":{"operationId":"listThemes","summary":"List portable KLIC themes","parameters":[{"name":"query","in":"query","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Theme catalog","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"https://design.klic.co.kr/api/v1/themes/{id}.json":{"get":{"operationId":"getTheme","summary":"Read one theme definition","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["klic","paper","ink","analysis","electronics","compute","integrations","console","workspace","spatial"]}}],"responses":{"200":{"description":"Theme definition","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"404":{"description":"Unknown theme","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"https://design.klic.co.kr/api/v1/theme-plan/{id}":{"get":{"operationId":"getThemeInstallPlan","summary":"Plan a verified standalone theme kit","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["klic","paper","ink","analysis","electronics","compute","integrations","console","workspace","spatial"]}},{"name":"profile","in":"query","schema":{"type":"string","enum":["core","studio","data"]}},{"name":"material","in":"query","schema":{"type":"string","enum":["flat","glass","solid-glass","liquid-glass"]}},{"name":"mode","in":"query","schema":{"type":"string","enum":["system","light","dark"]}}],"responses":{"200":{"description":"Theme installation plan","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"400":{"description":"Invalid selection","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}},"https://design.klic.co.kr/api/v1/theme-bundles/{id}/{profile}/{material}/{mode}.json":{"get":{"operationId":"getThemeBundle","summary":"Read a hash-verified theme bundle manifest","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["klic","paper","ink","analysis","electronics","compute","integrations","console","workspace","spatial"]}},{"name":"profile","in":"path","required":true,"schema":{"type":"string","enum":["core","studio","data"]}},{"name":"material","in":"path","required":true,"schema":{"type":"string","enum":["flat","glass","solid-glass","liquid-glass"]}},{"name":"mode","in":"path","required":true,"schema":{"type":"string","enum":["system","light","dark"]}}],"responses":{"200":{"description":"Theme bundle manifest","content":{"application/json":{"schema":{"type":"object","properties":{"designSystem":{"$ref":"#/components/schemas/DesignSystem"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a retry is allowed"}}},"503":{"description":"Quota storage unavailable; retry later"}}}}},"components":{"securitySchemes":{"quotaKey":{"type":"apiKey","in":"header","name":"X-KLIC-API-Key","description":"Optional server-allowlisted quota exemption; no admin permissions."}},"schemas":{"Item":{"type":"object","required":["kind","id","name","description","category","status","route","source"],"properties":{"kind":{"enum":["component","block"]},"id":{"type":"string","pattern":"^[a-z0-9-]{1,90}$"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"status":{"enum":["ready","planned"]},"route":{"type":"string","pattern":"^#(?:component|blocks)/"},"source":{"oneOf":[{"type":"null"},{"type":"object","required":["path","language","usage","notice"],"properties":{"path":{"type":"string"},"language":{"enum":["html","tsx"]},"usage":{"const":"reference"},"notice":{"type":"string"}}}]}}},"Registry":{"type":"object","required":["schemaVersion","release","metadata","counts","capabilities","policy","items"],"properties":{"metadata":{"type":"object"},"counts":{"type":"object"},"capabilities":{"type":"object"},"policy":{"type":"object"},"designSystem":{"type":"object","required":["schemaVersion","revision","namespace","tokenLayers","dimensions","presetPolicy","conflictResolution","provenance","links"],"properties":{"adoptionPolicy":{"type":"object","required":["selection","evidence"],"properties":{"selection":{"type":"string"},"evidence":{"type":"string"}}},"changePolicy":{"type":"object","required":["scope","surfaces","completion"],"properties":{"scope":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"completion":{"type":"string"}}},"schemaVersion":{"const":"1.0"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"namespace":{"const":"klic."},"tokenLayers":{"const":["Primitive","Brand","Semantic","Component"]},"dimensions":{"type":"array","minItems":7,"maxItems":7},"presetPolicy":{"type":"object"},"conflictResolution":{"type":"array"},"provenance":{"type":"object"},"links":{"type":"object"}}},"schemaVersion":{"const":"1.0"},"release":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}},"DesignSystem":{"type":"object","required":["schemaVersion","revision","namespace","tokenLayers","dimensions","presetPolicy","conflictResolution","provenance","links"],"properties":{"adoptionPolicy":{"type":"object","required":["selection","evidence"],"properties":{"selection":{"type":"string"},"evidence":{"type":"string"}}},"changePolicy":{"type":"object","required":["scope","surfaces","completion"],"properties":{"scope":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"completion":{"type":"string"}}},"schemaVersion":{"const":"1.0"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"namespace":{"const":"klic."},"tokenLayers":{"const":["Primitive","Brand","Semantic","Component"]},"dimensions":{"type":"array","minItems":7,"maxItems":7},"presetPolicy":{"type":"object"},"conflictResolution":{"type":"array"},"provenance":{"type":"object"},"links":{"type":"object"}}}}}}