aid: urbanstems name: UrbanStems description: >- UrbanStems is a direct-to-consumer flower and gifting company founded on Valentine's Day 2014 in Washington, DC, selling modern bouquets, plants, gifts and centerpieces with same-day delivery in major US cities and next-day delivery nationwide, sourced through a vertically integrated supply chain that buys direct from Rainforest Alliance Certified farms. Its storefront runs on Shopify at urbanstems.com, and the company exposes a genuine agent-facing commerce surface rather than a developer API program: a published /llms.txt and /agents.md, a /.well-known/ucp merchant profile implementing the Universal Commerce Protocol (UCP 2026-08-25), and a live unauthenticated Model Context Protocol endpoint offering thirteen catalog, cart, checkout and order tools that lets an agent search the catalog and drive a buyer-approved purchase end to end. image: https://urbanstems.com/cdn/shop/t/637/assets/organization-image_large.png?v=133620255960512887901788204824 url: https://raw.githubusercontent.com/api-evangelist/urbanstems/refs/heads/main/apis.yml x-type: company x-source: harvest:secondary-market specificationVersion: '0.20' created: '2026-09-02' modified: '2026-09-02' tags: - Company - Commerce - E-Commerce - Retail - Flowers - Gifting - Agentic Commerce - Universal Commerce Protocol - Model Context Protocol - Shopify - Direct to Consumer maintainers: - FN: Kin Lane email: kin@apievangelist.com - FN: APIs.json email: info@apis.io apis: - aid: urbanstems:urbanstems-commerce-mcp-api name: UrbanStems Commerce MCP API description: >- The agent-facing commerce surface for the UrbanStems store, implementing the Universal Commerce Protocol (dev.ucp.shopping) over MCP. Thirteen tools cover catalog search and lookup, product detail, cart create/update/cancel, checkout create/update/complete/cancel, and order retrieval. Anonymous — no API key or OAuth token is required to list tools or search the catalog — but completing a checkout requires an idempotency key and contemporaneous buyer approval of payment. humanURL: https://urbanstems.com/agents.md baseURL: https://274513-24.myshopify.com/api/ucp/mcp tags: - Commerce - Catalog - Cart - Checkout - Orders - Agentic Commerce properties: - type: Documentation url: https://urbanstems.com/agents.md - type: MCPServer url: mcp/urbanstems-mcp.yml - type: ToolCrosswalk url: mcp/urbanstems-tool-crosswalk.yml - type: WellKnown url: well-known/urbanstems-ucp.json - type: Authentication url: authentication/urbanstems-authentication.yml - type: Conventions url: conventions/urbanstems-conventions.yml - type: Idempotency url: conventions/urbanstems-conventions.yml - type: DataModel url: data-model/urbanstems-data-model.yml - type: ErrorCatalog url: errors/urbanstems-problem-types.yml - type: RateLimits url: rate-limits/urbanstems-rate-limits.yml - aid: urbanstems:urbanstems-storefront-json-api name: UrbanStems Storefront JSON API description: >- The read-only storefront JSON endpoints UrbanStems documents for agents in its own /llms.txt and /agents.md — product JSON at /products/{handle}.json, collection product listings at /collections/{handle}/products.json, and the sitemap set including a dedicated agentic-discovery sitemap. No authentication is required. These are Shopify Online Store routes served on the UrbanStems domain and named by UrbanStems in its own agent instructions. humanURL: https://urbanstems.com/llms.txt baseURL: https://urbanstems.com x-base-note: >- The site root IS the API base for this entry, not a marketing URL standing in for one. Shopify Online Store JSON routes are served off the storefront origin — https://urbanstems.com/products/{handle}.json returned HTTP 200 application/json on 2026-09-02 — and UrbanStems names exactly these paths in its own /llms.txt. The other api entry deliberately carries a different host (274513-24.myshopify.com), which is where the MCP endpoint actually answers; the two bases disagree because the two surfaces genuinely live on different hosts. tags: - Products - Collections - Catalog - Sitemap properties: - type: Documentation url: https://urbanstems.com/llms.txt - type: LLMsTxt url: llms/urbanstems-llms.txt common: - type: DomainSecurity url: security/urbanstems-domain-security.yml - type: Website url: https://urbanstems.com/ - type: Documentation url: https://urbanstems.com/agents.md - type: Support url: https://help.urbanstems.com/en-US - type: Blog url: https://urbanstems.com/blogs/news - type: BlogRSS url: https://urbanstems.com/blogs/news.atom - type: SignUp url: https://urbanstems.com/account/register - type: Login url: https://urbanstems.com/account/login - type: TermsOfService url: https://urbanstems.com/policies/terms-of-service - type: PrivacyPolicy url: https://urbanstems.com/policies/privacy-policy - type: GitHubOrganization url: https://github.com/urbanstems - type: MCPServer url: mcp/urbanstems-mcp.yml - type: ToolCrosswalk url: mcp/urbanstems-tool-crosswalk.yml - type: LLMsTxt url: llms/urbanstems-llms.txt - type: WellKnown url: well-known/urbanstems-well-known.yml - type: Authentication url: authentication/urbanstems-authentication.yml - type: OAuthScopes url: scopes/urbanstems-scopes.yml - type: Conventions url: conventions/urbanstems-conventions.yml - type: Idempotency url: conventions/urbanstems-conventions.yml - type: ErrorCatalog url: errors/urbanstems-problem-types.yml - type: RateLimits url: rate-limits/urbanstems-rate-limits.yml - type: Plans url: plans/urbanstems-plans-pricing.yml - type: Lifecycle url: lifecycle/urbanstems-lifecycle.yml - type: Conformance url: conformance/urbanstems-conformance.yml - type: DataModel url: data-model/urbanstems-data-model.yml - type: AgentSkill url: skills/_index.yml - type: Packages url: packages/urbanstems-packages.yml x-enrichment: date: '2026-09-02' status: enriched artifacts_added: 26 pass: local-v1 x-coverage: state: covered