API, MCP and CLI

Everything on the site works from code too. Personal tools need an API key: create one in Account.

CLI

npx mums.flower login            # paste your API key
npx mums.flower moms add "Mom" --birthday 05-14 --flowers peony,carnation
npx mums.flower upcoming
npx mums.flower card --to Mom --from "Sam" --message "Love you!" --flowers peony,tulip
npx mums.flower send <card-id> mom@example.com
npx mums.flower flowers peony
npx mums.flower mcp              # MCP over stdio, for desktop assistants

MCP

Streamable HTTP at https://mums.flower.pit.world/mcp. Tools: list_flowers, flower_meaning, mothers_day (no key needed); list_moms, add_mom, update_mom, upcoming, create_card, send_card (send Authorization: Bearer <key>).

{
  "mcpServers": {
    "mums.flower": {
      "url": "https://mums.flower.pit.world/mcp",
      "headers": { "Authorization": "Bearer mf_..." }
    }
  }
}

Or run it locally over stdio: MUMS_API_KEY=mf_... npx mums.flower mcp.

API

JSON at https://mums.flower.pit.world/api/v1 (the index lists every endpoint).

curl https://mums.flower.pit.world/api/v1/mothers-day?country=UK
curl -H "Authorization: Bearer mf_..." https://mums.flower.pit.world/api/v1/upcoming
curl -X POST -H "Authorization: Bearer mf_..." -H "content-type: application/json" \
  -d '{"name":"Mom","birthday":"05-14","country":"US","favoriteFlowers":["peony"]}' \
  https://mums.flower.pit.world/api/v1/moms
curl -X POST -H "Authorization: Bearer mf_..." -H "content-type: application/json" \
  -d '{"toName":"Mom","fromName":"Sam","message":"Love you","flowers":["peony","tulip"]}' \
  https://mums.flower.pit.world/api/v1/cards

Flowers: carnation chrysanthemum rose peony tulip lily orchid gerbera sunflower daisy hydrangea lilac iris freesia alstroemeria ranunculus lavender sweet-pea gardenia magnolia forget-me-not zinnia camellia baby-breath