For AI Agents & Developers
Garden Flowers is the world's first
agent-native luxury florist.
We expose a complete Agent Commerce Protocol — a machine-readable catalog, an MCP server, OAuth-scoped agent registration, and programmatic Stripe checkout in AED. Any autonomous AI agent can discover, choose, and order flowers end-to-end.
Based in Dubai. Same-day delivery across the UAE. No scraping required — agents speak directly to our API.
What agents can do here
OpenAPI 3.0.3 catalog
A machine-readable spec covers products, variants, cart, checkout, and payment verification. No scraping, no guesswork.
openapi.json →MCP server
A Model Context Protocol endpoint exposes the catalog and ordering as agent tools, ready for Claude, ChatGPT, and custom agents.
/api/mcp →OAuth-scoped agents
Agents register and receive Bearer tokens with catalog:read, orders:read, and orders:write scopes — full RFC 9727 metadata included.
auth.md →Programmatic checkout
POST /api/v1/checkout returns a Stripe payment_url in AED. End-to-end ordering, no human-in-the-loop required.
view spec →Order a bouquet in 3 steps
Public catalog reads need no authentication. Checkout requires an agent
token with the orders:write scope — see auth.md.
# 1) Browse the catalog (no auth needed)
curl https://gardenflowers.ae/api/v1/products
# 2) Inspect one product + variants
curl https://gardenflowers.ae/api/v1/products/santorini
# 3) Create an order → get a Stripe payment URL (AED)
curl -X POST https://gardenflowers.ae/api/v1/checkout \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your_agent_token>" \
-d '{
"items": [{ "slug": "santorini", "qty": 1 }],
"customer": { "name": "Agent Bot", "phone": "+971500000000" },
"delivery": { "address": "Downtown Dubai", "date": "2026-08-01" }
}'
# Response → { "payment_url": "https://...", "order_id": 1234 }
# 4) Confirm payment status after the Stripe redirect
curl https://gardenflowers.ae/api/v1/orders/1234/verify-payment
# → { "status": "paid", "order_id": 1234 }Core endpoints
| Method | Endpoint |
|---|---|
| GET | /api/v1/products |
| GET | /api/v1/products/{slug} |
| GET | /api/v1/categories |
| POST | /api/v1/checkout |
| POST | /api/v1/cart/items |
| GET | /api/v1/orders/{id}/verify-payment |
Full schema, error codes, and authentication details in the OpenAPI 3.0.3 spec.
Agent discovery
Standard discovery surfaces are published so any conformant agent can find and use us automatically — no onboarding call required.