Flower, Fruit Basket, Balloon Delivery by Apoth3osis

Name: Flower, Fruit Basket, Balloon Delivery
Brand: Apoth3osis
SKU: 6978d75991f9084339798ede
Availability: InStock

Flower, Fruit Basket, Balloon Delivery

Physical

Available ActionsEach successful request consumes credits as outlined below.

list_categoriessearch_productsget_order_totalplace_orderget_orderlist_orders

Details

Now your agent can send beautiful flower arrangements, balloon bouquets, and even fruit baskets! FloristOne delivers anywhere in the US and Canada, with same-day or scheduled delivery. Browse curated collections for birthdays, anniversaries, sympathy, and special occasions. Handle corporate flower and gift delivery in seconds. Send sympathy arrangements, employee recognition gifts, client thank-yous, and more. Add a personalized message on behalf of your company and choose same-day or scheduled delivery. The easy way to manage personal and business gifting in seconds. ***Phone app installation required to approve credit card payment*** Download from here - https://www.agentpmt.com/download-mobile-app

Use Cases

Send birthday flowers with a personalized message, order sympathy arrangements for a funeral home, browse anniversary and romance collections, schedule flower delivery for a specific date, thank a client with a fruit basket, recognize an employee with a surprise delivery, send get-well wishes to a hospital, congratulate someone with a balloon bouquet

Credentials

sender-address *

other

sender-contact-information *

other

Manage credentials in your dashboard.

Actions(6)

list_categories0 params

Returns all available product categories grouped by type (Occasions, Product Types, Funeral, Price Ranges, Seasonal, Other).

No parameters for this action.

search_products5 params

Search for flower products by category name/alias or by a specific product code. Provide exactly one of category or product_code.

categorystring

Category name, alias, or code from list_categories (e.g., "Birthday", "roses", "bd")

product_codestring

Florist One product code (e.g., "F1-509", "E2-4305")

limitinteger

Max results to return (default 12, max 50)

Default: 12

Range: 1 - 50

pageinteger

Page number for pagination (1-based, default 1)

Default: 1

Range: 1 - ...

sortstring

Sort order (default: popularity)

Values:

popularityprice_ascprice_descazza

get_order_total3 params(2 required)

Get the full price breakdown (product price, delivery fee, tax, order total) and resolved delivery date for a product and recipient ZIP code. Must be called before place_order.

product_coderequiredstring

Florist One product code from search results

recipient_zipcoderequiredstring

Recipient's ZIP/postal code

delivery_datestring

Desired delivery date (MM-DD-YYYY). If omitted, the soonest available date is returned.

place_order7 params(5 required)

Place a flower delivery order. Requires calling get_order_total first and confirming the total with the user. A credit card request is sent to the user's mobile app after calling this action.

product_coderequiredstring

Florist One product code to order

confirmed_totalrequirednumber

The order_total value returned by get_order_total, confirmed by the user

delivery_daterequiredstring

Delivery date from get_order_total (MM-DD-YYYY)

recipientrequiredobject

Delivery recipient information

Properties:

name*(string)- Recipient's full name

phone*(string)- 10-digit phone number

address1*(string)- Street address

address2(string)- Apt/suite/unit (optional)

city*(string)- City

state*(string)- 2-letter state code

zipcode*(string)- ZIP/postal code

institution(string)- Hospital, funeral home, or other facility name (optional)

card_messagerequiredstring

Message on the card (max 200 characters)

special_instructionsstring

Delivery instructions (max 100 characters)

idempotency_keystring

Optional key to prevent duplicate orders when retrying

get_order1 param(1 required)

Look up a completed order by its Florist One confirmation number.

ordernorequiredstring

Florist One confirmation number

list_orders2 params

List past flower delivery orders with pagination.

limitinteger

Max results to return (default 12, max 50)

Default: 12

Range: 1 - 50

offsetinteger

Skip first N results (default 0)

Default: 0

Range: 0 - ...

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6978d75991f9084339798ede",
    "parameters": {
      "action": "list_categories"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6978d75991f9084339798ede",
    "parameters": {
        "action": "list_categories"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6978d75991f9084339798ede",
  parameters: {
    "action": "list_categories"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6978d75991f9084339798ede",
  parameters: {
    "action": "list_categories"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Florist One Flowers

Overview

Search flower products by category or product code, get full pricing with delivery fees and tax, and place flower delivery orders across the US. Prices shown in search results are product prices only — a $19.99 delivery fee and applicable sales tax are added at checkout.

Actions

list_categories

Returns all available product categories grouped by type.

Required fields: none

Example:

{"action": "list_categories"}

Returns categories grouped as: Occasions (Best Sellers, Every Day, Birthday, Anniversary, Love & Romance, Get Well, New Baby, Thank You, Funeral and Sympathy), Product Types (Centerpieces, One Sided Arrangements, Vased Arrangements, Roses, Fruit Baskets, Plants, Balloons), Funeral Product Types (Funeral Best Sellers, Funeral Table Arrangements, Funeral Baskets, Funeral Sprays, Funeral Plants, Funeral Inside Casket, Funeral Wreaths, Funeral Hearts, Funeral Crosses, Funeral Casket Sprays, Funeral Urn Arrangements), Price Ranges (Under $60, $60–$80, $80–$100, Above $100, plus funeral equivalents), Seasonal Holidays (Christmas, Easter, Valentine's Day, Mother's Day), and Other (All Products).

search_products

Search for flower products by category name or by a specific product code. Provide exactly one of category or product_code — not both.

Required fields (one of):

category (string) — category name or alias from list_categories (e.g., "Birthday", "roses", "funeral sprays")
product_code (string) — specific Florist One product code (e.g., "F1-509", "E2-4305")

Optional fields:

limit (integer, 1–50, default 12) — max results to return
page (integer, min 1, default 1) — page number for pagination
sort (string) — sort order: popularity (default), price_asc, price_desc, az, za

Example — search by category:

{"action": "search_products", "category": "Birthday", "limit": 6, "sort": "price_asc"}

Example — search by product code:

{"action": "search_products", "product_code": "E2-4305"}

Each product in results includes: code, name, price, dimension, description, thumbnail_url, image_url. The response also includes total_available for the total number of matching products.

get_order_total

Get the full price breakdown (product price, delivery fee, sales tax, order total) and resolved delivery date for a specific product and recipient ZIP code. You MUST call this before placing an order and confirm the total and delivery date with the user.

Required fields:

product_code (string) — the product code from search results
recipient_zipcode (string) — recipient's ZIP/postal code

Optional fields:

delivery_date (string, MM-DD-YYYY) — desired delivery date. If omitted, the soonest available date is returned.

Example:

{"action": "get_order_total", "product_code": "E2-4305", "recipient_zipcode": "30303"}

Example with specific date:

{"action": "get_order_total", "product_code": "E2-4305", "recipient_zipcode": "30303", "delivery_date": "04-15-2026"}

Returns: product_code, product_name, product_price, delivery_fee, tax, order_total, delivery_date, recipient_zipcode. If the requested date is unavailable, the response includes delivery_date_unavailable: true and a list of available_dates — ask the user to choose one, then call get_order_total again with that date.

place_order

Place a flower delivery order. You MUST call get_order_total first and confirm the total and delivery date with the user before calling this action. The order will be rejected if confirmed_total is missing or does not match the current order total.

After calling place_order, a credit card request is sent to the user's mobile app. The order completes automatically once the user approves and enters their card details.

Required fields:

product_code (string) — the product to order
confirmed_total (number) — the order_total value returned by get_order_total, confirmed by the user
delivery_date (string, MM-DD-YYYY) — the delivery date from get_order_total
recipient (object) — delivery recipient with these fields:
- name (string, required) — recipient's full name
- phone (string, required) — 10-digit phone number
- address1 (string, required) — street address
- address2 (string, optional) — apt/suite/unit
- city (string, required) — city
- state (string, required) — 2-letter state code
- zipcode (string, required) — ZIP/postal code
- institution (string, optional) — hospital, funeral home, etc.
card_message (string, required, max 200 characters) — message on the card

Optional fields:

special_instructions (string, max 100 characters) — delivery instructions
idempotency_key (string) — prevents duplicate orders when retrying

Example:

{
  "action": "place_order",
  "product_code": "E2-4305",
  "confirmed_total": 84.97,
  "delivery_date": "04-15-2026",
  "recipient": {
    "name": "Jane Smith",
    "phone": "4045551234",
    "address1": "200 Peachtree St NW",
    "city": "Atlanta",
    "state": "GA",
    "zipcode": "30303"
  },
  "card_message": "Happy Birthday! Thinking of you."
}

get_order

Look up a completed order by its confirmation number.

Required fields:

orderno (string) — the Florist One confirmation number returned by place_order

Example:

{"action": "get_order", "orderno": "FO-123456"}

list_orders

List past orders with pagination.

Optional fields:

limit (integer, 1–50, default 12) — max results to return
offset (integer, min 0, default 0) — skip first N results

Example:

{"action": "list_orders", "limit": 10, "offset": 0}

Common Workflows

1. Browse and Order Flowers for a Birthday

list_categories — see available categories
search_products with category: "Birthday" — browse birthday arrangements
get_order_total with the chosen product_code and recipient_zipcode — get full pricing and delivery date
Confirm the total and delivery date with the user
place_order with the confirmed details — sends payment request to user's mobile app

2. Send Sympathy Flowers to a Funeral Home

search_products with category: "Funeral and Sympathy" — browse funeral arrangements
get_order_total with chosen product_code, recipient_zipcode, and optionally a specific delivery_date
Confirm pricing with user
place_order including institution in the recipient object (e.g., the funeral home name)

3. Check Order Status

get_order with the orderno from a previous order — view order details
Or list_orders to see all past orders

Important Notes

Pricing: Search result prices are product-only. The $19.99 delivery fee and sales tax are only shown via get_order_total.
Order flow is mandatory: Always call get_order_total before place_order. Always confirm the total and delivery date with the user. The order is rejected if confirmed_total does not match (tolerance: $0.01).
Payment: place_order does not complete the order immediately. It sends a credit card request to the user's mobile app. The order is fulfilled automatically after the user approves.
Same-day delivery cutoff: Same-day deliveries can only be processed if payment is approved by 12:00 PM in the recipient's time zone. If approved later, delivery is automatically moved to the next available date.
Date format: Always use MM-DD-YYYY format for delivery_date.
Idempotency: Use idempotency_key when retrying to prevent duplicate orders. If a matching pending or completed order exists, the existing order is returned instead of creating a new one.
Category matching: Categories accept names, aliases, and codes (e.g., "Birthday", "bday", "bd" all work). Use list_categories if unsure.
Card message limit: Maximum 200 characters for the card message, 100 characters for special instructions.
Phone numbers: Must include at least 10 digits. Country codes are stripped automatically.
US delivery only: ZIP codes must be valid US 5-digit codes (9-digit codes are truncated to 5). Canadian postal codes are also accepted.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 6978d75991f9084339798ede ("Flower, Fruit Basket, Balloon Delivery"). Then call the same tool with action 'call_tool', tool_id 6978d75991f9084339798ede, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Flower, Fruit Basket, Balloon Delivery

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Credentials

Actions(6)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Florist One Flowers

Overview

Actions

list_categories

search_products

get_order_total

place_order

get_order

list_orders

Common Workflows

1. Browse and Order Flowers for a Birthday

2. Send Sympathy Flowers to a Funeral Home

3. Check Order Status

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Workflows Using This Tool

Send Flowers and Thank You Card to Google Contact

Looking for help integrating AI into your business? Set up a free consultation.