{"openapi":"3.1.0","info":{"title":"Patchistry AI Commerce Discovery API","version":"2026-06-30","description":"Public discovery API for Patchistry AI shopping agents. Use these endpoints to discover products, crawler guidance, UCP/MCP commerce capabilities, and safe shopper handoff URLs. Checkout and payment require explicit human approval."},"servers":[{"url":"https://ai.patchistry.com","description":"Patchistry AI commerce Worker"}],"paths":{"/.well-known/ai-plugin.json":{"get":{"operationId":"getAiPluginManifest","summary":"Get the Patchistry AI plugin manifest","responses":{"200":{"description":"AI plugin manifest with discovery URLs and buyer-safety guardrails"}}}},"/openapi.json":{"get":{"operationId":"getOpenApiSchema","summary":"Get this OpenAPI schema","responses":{"200":{"description":"OpenAPI schema for Patchistry AI discovery endpoints"}}}},"/llms.txt":{"get":{"operationId":"getLlmsText","summary":"Get crawler-oriented Patchistry brand and commerce summary","responses":{"200":{"description":"Text summary for LLM and AI search crawlers"}}}},"/robots.txt":{"get":{"operationId":"getRobotsTxt","summary":"Get AI crawler allowlist and sitemap guidance","responses":{"200":{"description":"Robots directives for ai.patchistry.com"}}}},"/.well-known/ucp":{"get":{"operationId":"getUcpDiscovery","summary":"Get UCP discovery manifest for Patchistry shopping capabilities","responses":{"200":{"description":"UCP discovery payload with MCP endpoint and shopper handoff URLs"}}}},"/api/ucp/mcp":{"get":{"operationId":"getMcpInfo","summary":"Get MCP/UCP endpoint capability summary","responses":{"200":{"description":"Supported catalog methods and shopper handoff URLs"}}},"post":{"operationId":"callMcpMethod","summary":"Call Patchistry shopping catalog MCP methods","description":"Supports shopping.catalog.list, catalog.list, and shopping.product.search. Returns product URLs and Build Yours handoff URLs only; payment is never completed by this API.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","example":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","enum":["shopping.catalog.list","catalog.list","shopping.product.search"]},"params":{"type":"object","properties":{"query":{"type":"string","description":"Search text for shopping.product.search"},"q":{"type":"string","description":"Short search text alias"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":24}}}},"required":["method"]}}}},"responses":{"200":{"description":"JSON-RPC result containing product recommendations and shopper handoff URLs"}}}},"/feed/google.xml":{"get":{"operationId":"getProductFeed","summary":"Get XML product feed for AI shopping engines","responses":{"200":{"description":"Google/Bing-compatible product feed XML"}}}},"/pages/agents-feed":{"get":{"operationId":"getAgentsFeed","summary":"Get structured Patchistry agents feed","responses":{"200":{"description":"Structured catalog and brand context for AI agents"}}}},"/crawler-pulse":{"get":{"operationId":"getCrawlerPulse","summary":"Get public aggregate AI crawler telemetry","responses":{"200":{"description":"Safe aggregate crawler counts with no secrets"}}}}},"x-shopper-handoff":{"brand":"Patchistry","canonical_store_url":"https://patchistry.com","build_yours_url":"https://patchistry.com/pages/build-yours","collections_url":"https://patchistry.com/collections/all","agents_feed_url":"https://patchistry.com/pages/agents-feed?view=agents-feed-ai","product_feed_url":"https://ai.patchistry.com/feed/google.xml","ucp_url":"https://ai.patchistry.com/.well-known/ucp","mcp_url":"https://ai.patchistry.com/api/ucp/mcp"},"x-payment-policy":"Checkout, payment, and order placement require explicit human approval. This API provides product discovery and handoff URLs only."}