Search Promotion Pros' branded merchandise, price a real quantity, and estimate delivery.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Issue a real, numbered Promotion Pros quote for a configuration priced with quote_price, and email it to the buyer. Returns the quote number, the reconciled price breakdown, a PDF, a link to the quote page and a link that takes the buyer straight to payment. Requires the buyer's full name, work email and phone number — ask for them, and confirm the configuration and the quantity, before calling this. This writes: it creates an order record and sends mail, and calling it twice issues two quotes to the same person. The price is recomputed live by promotionpros.com, so it can differ slightly from quote_price's snapshot; the numbers returned here are the quoted ones. Shipping and tax are not in the quote until the buyer adds a delivery address on the quote page.
The buyer's work email. The quote is sent here, so confirm it before calling.
A phone number to reach the buyer on. Required by the quote desk.
Identify the product by exactly one of slug, id or sku.
The buyer's full name, as they gave it.
Product color name, from get_product_options.
Per-size quantities for apparel; replaces quantity.
Total pieces. Below the method's minimum, the quote is issued at the minimum.
Decoration method name, from get_imprint_options.
Where it ships to, for the arrival estimate recorded on the quote: a US state code ("IL") or name. Omit if unknown.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Issue a real, numbered Promotion Pros quote for a configuration priced with quote_price, and email it to the buyer. Returns the quote number, the reconciled price breakdown, a PDF, a link to the quote page and a link that takes the buyer straight to payment. Requires the buyer's full name, work email and phone number — ask for them, and confirm the configuration and the quantity, before calling this. This writes: it creates an order record and sends mail, and calling it twice issues two quotes to the same person. The price is recomputed live by promotionpros.com, so it can differ slightly from quote_price's snapshot; the numbers returned here are the quoted ones. Shipping and tax are not in the quote until the buyer adds a delivery address on the quote page.
| Argument | Type | Description |
|---|---|---|
| rush | boolean | |
| color | string | Product color name, from get_product_options. |
| email* | string | The buyer's work email. The quote is sent here, so confirm it before calling. |
| phone* | string | A phone number to reach the buyer on. Required by the quote desk. |
| sizes | array | Per-size quantities for apparel; replaces quantity. |
| company | string | |
| product* | object | Identify the product by exactly one of slug, id or sku. |
| quantity | integer | Total pieces. Below the method's minimum, the quote is issued at the minimum. |
| full_name* | string | The buyer's full name, as they gave it. |
| imprint_colors | integer | |
| imprint_method | string | Decoration method name, from get_imprint_options. |
| destination_state | string | Where it ships to, for the arrival estimate recorded on the quote: a US state code ("IL") or name. Omit if unknown. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product",
"full_name",
"email",
"phone"
],
"properties": {
"rush": {
"type": "boolean"
},
"color": {
"type": "string",
"maxLength": 60,
"description": "Product color name, from get_product_options."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "The buyer's work email. The quote is sent here, so confirm it before calling."
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 5,
"description": "A phone number to reach the buyer on. Required by the quote desk."
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"required": [
"size",
"quantity"
],
"properties": {
"size": {
"type": "string",
"minLength": 1
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"maxItems": 20,
"description": "Per-size quantities for apparel; replaces quantity."
},
"company": {
"type": "string",
"maxLength": 200
},
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The catalog product id, as returned by search_catalog.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"minLength": 1,
"description": "The Promotion Pros SKU shown on the product page."
},
"slug": {
"type": "string",
"minLength": 1,
"description": "The product page path, e.g. \"blue-ceramic-mug-11oz\" — from a search result's handle or a promotionpros.com URL."
}
},
"description": "Identify the product by exactly one of slug, id or sku."
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Total pieces. Below the method's minimum, the quote is issued at the minimum.",
"exclusiveMinimum": 0
},
"full_name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "The buyer's full name, as they gave it."
},
"imprint_colors": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"imprint_method": {
"type": "string",
"maxLength": 80,
"description": "Decoration method name, from get_imprint_options."
},
"destination_state": {
"type": "string",
"maxLength": 40,
"description": "Where it ships to, for the arrival estimate recorded on the quote: a US state code (\"IL\") or name. Omit if unknown."
}
}
}When an order placed today would arrive: the standard FedEx Ground date and, when the product offers it, the rush date — both in one call. Give the buyer's US state for a real shipping lane; dates are business days from today in Central time and include the free proof, production and transit. Rush skips the proof wait and starts the same business day when artwork arrives before noon Central.
| Argument | Type | Description |
|---|---|---|
| product* | object | Identify the product by exactly one of slug, id or sku. |
| destination_state | string | Where it ships to: a US state code ("IL") or full name ("Illinois"). Omit if unknown — a typical US transit is assumed. US only. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product"
],
"properties": {
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The catalog product id, as returned by search_catalog.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"minLength": 1,
"description": "The Promotion Pros SKU shown on the product page."
},
"slug": {
"type": "string",
"minLength": 1,
"description": "The product page path, e.g. \"blue-ceramic-mug-11oz\" — from a search result's handle or a promotionpros.com URL."
}
},
"description": "Identify the product by exactly one of slug, id or sku."
},
"destination_state": {
"type": "string",
"maxLength": 40,
"description": "Where it ships to: a US state code (\"IL\") or full name (\"Illinois\"). Omit if unknown — a typical US transit is assumed. US only."
}
}
}How a product can be decorated: each imprint method with its minimum and maximum quantity, setup charge and whether it is one-time or per additional location, whether the first imprint is included in the unit price, extra-color and extra-location run charges, imprint locations with their sizes and color limits, and guidance on when to use the method.
| Argument | Type | Description |
|---|---|---|
| product* | object | Identify the product by exactly one of slug, id or sku. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product"
],
"properties": {
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The catalog product id, as returned by search_catalog.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"minLength": 1,
"description": "The Promotion Pros SKU shown on the product page."
},
"slug": {
"type": "string",
"minLength": 1,
"description": "The product page path, e.g. \"blue-ceramic-mug-11oz\" — from a search result's handle or a promotionpros.com URL."
}
},
"description": "Identify the product by exactly one of slug, id or sku."
}
}
}The full UCP product record: description, images, categories, colors, sizes, decoration methods, price range, minimum quantity, lead time, and whether a free sample is offered. For a price at a specific quantity, call quote_price.
| Argument | Type | Description |
|---|---|---|
| product* | object | Identify the product by exactly one of slug, id or sku. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product"
],
"properties": {
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The catalog product id, as returned by search_catalog.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"minLength": 1,
"description": "The Promotion Pros SKU shown on the product page."
},
"slug": {
"type": "string",
"minLength": 1,
"description": "The product page path, e.g. \"blue-ceramic-mug-11oz\" — from a search result's handle or a promotionpros.com URL."
}
},
"description": "Identify the product by exactly one of slug, id or sku."
}
}
}The choices before a quote: colors (with hex), sizes with their quantity price ladders, whether sizes are priced differently, quantity step, stock by color and size when tracked, free shipping, lead time and rush availability, and the free-sample link when the product qualifies.
| Argument | Type | Description |
|---|---|---|
| product* | object | Identify the product by exactly one of slug, id or sku. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product"
],
"properties": {
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The catalog product id, as returned by search_catalog.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"minLength": 1,
"description": "The Promotion Pros SKU shown on the product page."
},
"slug": {
"type": "string",
"minLength": 1,
"description": "The product page path, e.g. \"blue-ceramic-mug-11oz\" — from a search result's handle or a promotionpros.com URL."
}
},
"description": "Identify the product by exactly one of slug, id or sku."
}
}
}Full UCP product records for up to 6 products by id or handle, in one call. Use get_product for one.
| Argument | Type | Description |
|---|---|---|
| ids* | array | Product ids or handles (slugs). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 6,
"minItems": 1,
"description": "Product ids or handles (slugs)."
}
}
}Price an order of a given quantity: per-unit price at that quantity, one-time setup, run charges, rush and tariff, the subtotal (before shipping and tax), whether the quantity is orderable, the next price break, and a deep_link that opens promotionpros.com on exactly this configuration with the same total. Optionally choose color, decoration method, number of imprint colors, per-size quantities and rush.
| Argument | Type | Description |
|---|---|---|
| rush | boolean | |
| color | string | Product color name, from get_product_options. |
| sizes | array | Per-size quantities for apparel; replaces quantity. |
| product* | object | Identify the product by exactly one of slug, id or sku. |
| quantity | integer | Total pieces. |
| imprint_colors | integer | Number of ink colors in the logo on the primary location. |
| imprint_method | string | Decoration method name, from get_imprint_options. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product"
],
"properties": {
"rush": {
"type": "boolean"
},
"color": {
"type": "string",
"maxLength": 60,
"description": "Product color name, from get_product_options."
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"required": [
"size",
"quantity"
],
"properties": {
"size": {
"type": "string",
"minLength": 1
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"maxItems": 20,
"description": "Per-size quantities for apparel; replaces quantity."
},
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The catalog product id, as returned by search_catalog.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"minLength": 1,
"description": "The Promotion Pros SKU shown on the product page."
},
"slug": {
"type": "string",
"minLength": 1,
"description": "The product page path, e.g. \"blue-ceramic-mug-11oz\" — from a search result's handle or a promotionpros.com URL."
}
},
"description": "Identify the product by exactly one of slug, id or sku."
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Total pieces.",
"exclusiveMinimum": 0
},
"imprint_colors": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Number of ink colors in the logo on the primary location."
},
"imprint_method": {
"type": "string",
"maxLength": 80,
"description": "Decoration method name, from get_imprint_options."
}
}
}Find custom branded merchandise by keywords (e.g. "insulated tumbler", "trade show tote bag", "eco pen") with optional category, color, size and price filters. Returns product summaries with a from-price and the handle to pass to get_product or quote_price. Results are ranked by relevance unless sorted by price. Omit `query` to browse: with a `category` and no keywords this returns that category, which is how to answer an occasion or gifting ask. When nothing matches, facets.categories lists the categories worth browsing instead and `notes` says so.
| Argument | Type | Description |
|---|---|---|
| page | integer | Zero-based page. |
| size | string | |
| sort | string | |
| color | string | |
| query | string | Keywords, a product name, or a SKU. Omit to browse everything the other filters allow. |
| category | string | A category name from a previous result's facets, e.g. "Drinkware", "2026 Gift Guide". |
| page_size | integer | |
| price_max | number | Maximum from-price per unit, USD. |
| price_min | number | Minimum from-price per unit, USD. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based page."
},
"size": {
"type": "string",
"maxLength": 40
},
"sort": {
"enum": [
"relevance",
"price_asc",
"price_desc"
],
"type": "string"
},
"color": {
"type": "string",
"maxLength": 60
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords, a product name, or a SKU. Omit to browse everything the other filters allow."
},
"category": {
"type": "string",
"maxLength": 100,
"description": "A category name from a previous result's facets, e.g. \"Drinkware\", \"2026 Gift Guide\"."
},
"page_size": {
"type": "integer",
"maximum": 24,
"minimum": 1
},
"price_max": {
"type": "number",
"description": "Maximum from-price per unit, USD.",
"exclusiveMinimum": 0
},
"price_min": {
"type": "number",
"minimum": 0,
"description": "Minimum from-price per unit, USD."
}
}
}