{"openapi":"3.1.0","info":{"title":"Ur&Penn Agentic Commerce & Discovery API","version":"1.0.0","description":"OpenAPI 3.1.0 specification for Ur&Penn (uropenn.se) Universal Commerce Protocol (UCP 2026-04-08), Model Context Protocol (MCP), Cart Handoff, and Product Feeds.","contact":{"name":"Ur&Penn AB","url":"https://uropenn.se/developers","email":"kundservice@uropenn.se"}},"servers":[{"url":"https://uropenn.se","description":"Production Storefront & UCP Gateway"}],"paths":{"/.well-known/ucp":{"get":{"operationId":"getUcpDiscoveryProfile","summary":"Get UCP 2026-04-08 Discovery Profile","responses":{"200":{"description":"UCP 2026-04-08 discovery document"}}}},"/api/ucp/v1/carts":{"post":{"operationId":"createUcpCart","summary":"Create a UCP shopping cart session","security":[{"UcpAgentHeader":[]}],"responses":{"200":{"description":"Created cart session with checkout handoff URL"},"401":{"description":"Missing or invalid UCP agent header or RFC 9421 signature"}}}},"/api/ucp/mcp":{"post":{"operationId":"invokeUcpMcp","summary":"Invoke UCP MCP JSON-RPC 2.0 tool (tools/list, tools/call)","security":[{"UcpAgentHeader":[]}],"responses":{"200":{"description":"JSON-RPC 2.0 response"},"401":{"description":"Unauthorized"}}}},"/api/docs/mcp":{"post":{"operationId":"invokeDocsMcp","summary":"Invoke public read-only Documentation & Store Locator MCP JSON-RPC 2.0 endpoint","responses":{"200":{"description":"JSON-RPC 2.0 response"}}}},"/cart/handoff":{"get":{"operationId":"handoffCartToCheckout","summary":"Populate storefront cart by SKU and redirect human user to Svea/BankID checkout","parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string"}},{"name":"items","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"307":{"description":"Redirect to /checkout with populated cart"}}}},"/feed/openai-products.jsonl":{"get":{"operationId":"getOpenAiProductFeed","summary":"Download OpenAI Agentic Commerce Product Feed (JSONL)","responses":{"200":{"description":"Newline-delimited JSON product records"}}}}},"components":{"securitySchemes":{"UcpAgentHeader":{"type":"http","scheme":"bearer","description":"Dedicated UCP token or RFC 9421 HTTP Message Signature (Signature + Signature-Input + UCP-Agent)."}}}}