{"openapi":"3.1.0","info":{"title":"Kaheli Agent Discovery API","version":"1.0.0","description":"Discovery document for Kaheli agent-readable storefront catalog surfaces."},"servers":[{"url":"https://kaheli.pl"}],"paths":{"/api/ucp/mcp":{"post":{"operationId":"callStorefrontCatalogMcp","summary":"Call the Shopify Storefront Catalog MCP endpoint","description":"Proxies JSON-RPC requests to Shopify's Storefront Catalog MCP endpoint. This is a catalog discovery API, not a payable API.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"jsonrpc":{"const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"number"}]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}},"required":["jsonrpc","method"]}}}},"responses":{"200":{"description":"JSON-RPC response from the storefront catalog MCP server.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Shopify rejected the MCP request, usually because required MCP metadata is missing."}}}},"/.well-known/mcp/server-card.json":{"get":{"operationId":"getMcpServerCard","summary":"Get the MCP Server Card","responses":{"200":{"description":"MCP Server Card discovery document.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"operationId":"getOauthAuthorizationServerMetadata","summary":"Get OAuth authorization server metadata","description":"Publishes Kaheli's agent authentication status. Kaheli does not issue OAuth/OIDC credentials for autonomous agents.","responses":{"200":{"description":"OAuth authorization server metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"operationId":"getOauthProtectedResourceMetadata","summary":"Get OAuth protected resource metadata","description":"Publishes Kaheli's resource authentication metadata for agent discovery.","responses":{"200":{"description":"OAuth protected resource metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/auth.md":{"get":{"operationId":"getAgentAuthenticationDocument","summary":"Get agent authentication instructions","responses":{"200":{"description":"Markdown instructions for agent authentication.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}}}