# Bloom Lane

> Bloom Lane is an agent-ready florist for personal gifts, partner gifts, and GTM outreach. Agents can search flowers and orchids, check delivery, prepare a secure Shopify checkout, and ask a person to approve payment.

## Start here

- [Agent ordering guide](https://bloomlaneflowers.com/agents): The shortest integration guide for MCP and REST clients.
- [Gift catalog](https://bloomlaneflowers.com/gifts): Human-readable flowers, orchids, and plant gifts.
- [Funeral flower delivery hub](https://bloomlaneflowers.com/funeral-flower-delivery): Verified New York destination directories, live delivery checks, and funeral-flower guidance.
- [Funeral destination verification method](https://bloomlaneflowers.com/guides/how-we-verify-funeral-home-destinations): How registry records become directly corroborated delivery pages.
- [What to send to a funeral](https://bloomlaneflowers.com/guides/what-to-send-to-a-funeral): A practical guide to service flowers, home arrangements, plants, donations, and support.
- [MCP server](https://bloom-lane-mcp.cosmicmarketing.workers.dev/mcp): Streamable HTTP MCP endpoint.
- [Bloom Lane UCP platform profile](https://bloom-lane-mcp.cosmicmarketing.workers.dev/.well-known/ucp): Capabilities used for Shopify UCP negotiation.
- [Shopify merchant UCP profile](https://westchester-floral-company.myshopify.com/.well-known/ucp): Native catalog, cart, checkout, and order capabilities for the Bloom Lane Shopify store.

## Recommended agent flow

1. Call search_gifts.
2. Call get_delivery_quote with the delivery ZIP code.
3. Call create_checkout with a unique idempotency key.
4. Give checkoutUrl to the person who will review and pay in Shopify.
5. Call get_gift_status for the latest state.
6. Call cancel_checkout if the unpaid checkout is no longer needed.

## Important rules

- The agent does not collect or transmit card details.
- create_checkout prepares an unpaid checkout. It does not place an order.
- A person reviews and pays on Shopify.
- Checkout links expire after 24 hours.
- cancel_checkout immediately invalidates a UCP checkout.
- Never claim that a gift was ordered until get_gift_status reports paid.
- Funeral-home directory records are delivery references. Bloom Lane is an independent florist and is not affiliated with listed funeral homes.
- Confirm the deceased person's name, destination address, viewing or service time, and delivery availability before checkout.

## REST API

- GET https://bloom-lane-mcp.cosmicmarketing.workers.dev/api/v1/gifts
- POST https://bloom-lane-mcp.cosmicmarketing.workers.dev/api/v1/delivery/quote
- POST https://bloom-lane-mcp.cosmicmarketing.workers.dev/api/v1/checkouts
- GET https://bloom-lane-mcp.cosmicmarketing.workers.dev/api/v1/gifts/{orderIntentId}
- DELETE https://bloom-lane-mcp.cosmicmarketing.workers.dev/api/v1/checkouts/{orderIntentId}