Ur&Penn Developer & AI Agent Portal
Official machine-readable discovery endpoints, product feeds, Universal Commerce Protocol (UCP 2026-04-08), Model Context Protocol (MCP), and WebMCP tools for uropenn.se.
1. Agent Discovery & Structured Manifests
| Endpoint | Format / Standard | Purpose |
|---|---|---|
| /llms.txt | Markdown (llms.txt) | Site summary, category taxonomy, shipping/return rules, and agent routing guide |
| /index.md | Markdown + YAML frontmatter | Markdown mirror of the storefront homepage (also served via Accept: text/markdown on /) |
| /pricing.md | Markdown + YAML frontmatter | Shipping tiers (39 SEK / free ≥ 499 SEK), return fee (49 SEK mail / 0 SEK in-store), and service prices |
| /auth.md | Markdown + YAML frontmatter | Authentication & security guide (public feeds vs UCP API keys / RFC 9421 signatures vs BankID) |
| /.well-known/ard.json | JSON (ARD 1.0) | Agent Readiness Discovery manifest |
| /.well-known/ai-catalog.json | JSON (AI Catalog 1.0) | Unified catalog of feeds, APIs, MCP servers, and skills |
| /.well-known/agent-card.json | JSON (A2A Agent Card) | Agent-to-Agent capability and skill declaration |
| /.well-known/agent-skills/index.json | JSON | Agent skills index with SHA-256 integrity digests |
| /.well-known/api-catalog | RFC 9727 application/linkset+json | IETF API Catalog linkset pointing to OpenAPI, UCP, and feeds |
| /.well-known/ucp | JSON (UCP 2026-04-08) | Google Universal Commerce Protocol discovery profile |
| /.well-known/mcp/server-card.json | JSON (MCP Server Card) | Model Context Protocol server metadata and tool schemas |
| /openapi.json | OpenAPI 3.1.0 JSON | OpenAPI specification for feeds, cart handoff, and UCP endpoints |
2. Product Catalog Feeds & Direct Cart Handoff
- OpenAI ChatGPT Product Feed (JSONL): /feed/openai-products.jsonl
- Google Merchant Center Feed (RSS 2.0 XML): /feed/google-shopping.xml
- Hello Retail Product Feed (JSON): /feed/hello-retail.json
- Direct Cart & Checkout Handoff:
https://uropenn.se/cart/handoff?id={sku}orhttps://uropenn.se/cart/handoff?items={sku1}:{qty1},{sku2}:{qty2}
3. CLI, SDK & MCP Quickstart
# Fetch Agent Readiness Discovery (ARD) curl -sS https://uropenn.se/.well-known/ard.json | jq . # Negotiate Markdown homepage representation curl -sS -H "Accept: text/markdown" https://uropenn.se/ # Connect an MCP client to the UCP MCP sandbox endpoint npx -y @modelcontextprotocol/inspector "https://uropenn.se/api/ucp/mcp?sandbox=true"
