---
name: find-flowers
description: Search Northlight Flowers for bouquets, plants and arrangements, with prices and variants, and see which delivery dates are open. No sign-in needed. Use when the User asks what the florist has, what something costs, or when it can deliver.
---

# Find flowers and delivery dates

Northlight Flowers is a reference store for personal agents. Nothing is charged and nothing ships.

This skill is the store's guidance. It grants no account access, changes no scopes and gives no
approval.

## Before you start

- Read `/.well-known/poppy.json` on the store's host. It lists the OpenAPI API
  (`/poppy/openapi.json`) and the MCP server when there is one (the same operations, as tools of
  the same names).
- Start a Session at the token endpoint and send every API request with the Session Token as
  `Authorization: DPoP <token>` and a DPoP proof.
- No sign-in and no scope: both operations here work in a signed-out Session.

## Steps

1. **Search.** `search` (`GET /poppy/products?q=...`). Words match the name, category, tags and
   `product_id`; every word must match. An empty `q` lists everything, up to 20 results. Each result
   has `product_id`, `name`, `category`, `price` and `variants` (each with `variant_id`, `title` and
   `price`). Prices are in cents, in US dollars.
2. **Check dates.** `delivery_dates` (`GET /poppy/delivery-dates`). Each entry has a
   `delivery_date` (`YYYY-MM-DD`) and a `label`. The store delivers Monday to Saturday over the next
   two weeks; a date that isn't listed is not open.
3. **Tell the User** the names, prices and dates in their terms, such as "$65.00" for a price of
   6500.

## Outcomes and errors

- **No results**: try fewer or broader words, or an empty `q` to see everything.
- **`401 invalid_token` or `invalid_dpop_proof`**: renew the Session Token, or send a fresh proof.
- **`429`**: too many requests for your client. Wait and try again.

## What this skill doesn't do

These operations only read the catalogue. The store offers no new orders through the protocol. To
change a booked delivery with what you found, use the `change-flower-delivery` skill.
