Avdeb MCP
Deja que los asistentes de IA compren en AVDEB por ti: busca pegatinas, calcomanías, placas identificativas y regalos, consulta los detalles de los productos y las políticas de la tienda, y obtén un presupuesto exacto con descuentos y gastos de envío.
Documentación
AVDEB MCP server
Let AI assistants shop AVDEB for you: search stickers, decals, name badges and gifts, read product details and store policies, and get an exact quote with discounts and shipping. The server is free, needs no account, and is read-only — buyers always complete checkout on avdeb.com.
At a glance
Endpoint
Transport
MCP Streamable HTTP — stateless, JSON responses (no SSE stream, no sessions)
Authentication
None. Every tool reads public store data
Access
6 tools, all read-only — nothing is created, changed, reserved or charged
Protocol versions
2025-11-25, 2025-06-18, 2025-03-26
Market
Ships to US addresses only; prices in USD
Price
Free
Server version
1.0.0
Connect
Add the endpoint as a remote MCP server (custom connector) in any client that supports Streamable HTTP. No OAuth or API key is required.
https://avdeb.com/mcp
- Claude — Settings → Connectors → Add custom connector → paste the URL.
- ChatGPT — in developer mode, add a connector with the URL and “No authentication”.
- Meta Muse — ask Muse to connect to the MCP server at the URL above.
- MCP Inspector — run
npx @modelcontextprotocol/inspector, choose Streamable HTTP and enter the URL.
Raw JSON-RPC
curl -s https://avdeb.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
curl -s https://avdeb.com/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"cat sticker","limit":3}}}'
How a purchase works
- Find products with
search_productsorbrowse_category. - Read options, variants and personalization fields with
get_product. - Price the exact basket with
quote_order— it validates every choice and applies the same discount and shipping rules as checkout. - The buyer adds the items on the product pages and checks out at avdeb.com/cart (guest checkout, Stripe).
Sales tax is calculated at checkout from the full shipping address. Products made in an on-site designer (pet photo stickers, QR code stickers, NFC keychains and review stands) are marked ordering_mode: website_designer and are ordered on their product page.
Tools
Every tool is classified Read: it only retrieves information and has no side effects (MCP annotations readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false). There are no write or sensitive-write tools.
search_products
Search products Read
Search the AVDEB catalog (stickers, decals, name badges, NFC keychains, 3D printed goods, gifts) by keywords. Returns matching products with price range, stock and product page URL.
Input
| Name | Type | Details |
|---|---|---|
| query * | string | What the shopper is looking for, e.g. 'cat laptop sticker'. ( 2–200 chars) |
| limit | integer | ( 1–20, default 8) |
* required
Returns
query
The search text that was used
results[]
handle, title, url, type, price { min, max, currency }, in_stock, personalized, ordering_mode (standard | website_designer), image
tip
Only when nothing matched
Example request: “Find a cute cat sticker for my laptop under $5.”
get_product
Get product details Read
Full details for one product: description, options and variants with prices and stock, personalization fields, images, categories, FAQs and return eligibility.
Input
| Name | Type | Details |
|---|---|---|
| handle * | string | Product handle, or a product URL like https://avdeb.com/store/{handle}/. ( 1–200 chars) |
* required
Returns
handle, title, url, type, price, in_stock, personalized, ordering_mode, image
Same summary as search results
description
Up to 2,000 characters
options[]
{ title, values[] }
variants[]
{ variant_id, title, price, compare_at_price, options, available } — up to 50
personalization_fields[]
{ key, label, required, max_length, multiline }
images[]
Up to 6 { url, alt }
categories[]
{ name, slug }
faqs[]
Up to 8 { question, answer }
returns
Return eligibility for this product
seller
AVDEB, or the designer credit for creator-marketplace products
ordering
{ mode, note } — website_designer products are ordered on the product page
Example request: “What sizes and finishes does the angel cat sticker come in?”
browse_category
Browse a category Read
Products in one category (slug from list_categories), with price range, stock and product page URL.
Input
| Name | Type | Details |
|---|---|---|
| slug * | string | ( 1–120 chars) |
| page | integer | ( 1–50, default 1) |
| page_size | integer | ( 1–24, default 12) |
* required
Returns
category, page, page_size, total
Paging information
products[]
Product summaries (as in search results)
Example request: “Show me AVDEB's car decals.”
get_store_info
Store policies Read
Shipping rates and free-shipping threshold, processing and delivery times, current offers, returns, payment and how ordering works at AVDEB.
Input
No arguments.
Returns
ships_to, currency
Shipping countries and price currency
shipping_options[]
{ id, name, price }
free_shipping
{ min_subtotal, applies_to, members_only } or null
processing, transit, estimated_delivery_if_ordered_now
Handling cut-off, carrier transit time and dates
offers[]
Automatic discounts currently running
returns, payment, how_to_order, policies, contact
Store policies and links
Example request: “How fast does AVDEB ship to California, and when is shipping free?”
quote_order
Quote an order Read
Price a prospective order: validates products, variants and personalization, applies the automatic multi-buy offer or a coupon, and returns shipping options and the total before sales tax (tax is calculated at checkout). Read-only: it doesn't create an order, reserve stock or charge anything.
Input
| Name | Type | Details |
|---|---|---|
| items * | array of objects | ( 1–20 items) |
| items[].handle * | string | Product handle (from search_products, browse_category or get_product). ( 1–200 chars) |
| items[].variant_id | string | Variant id from get_product. Use this or options. ( ≤ 40 chars) |
| items[].options | object (string → string) | Option selections from get_product, e.g. {"Size": "3\" x 3\""}. Use this or variant_id. |
| items[].quantity | integer | ( 1–100, default 1) |
| items[].personalization | object (string → string) | Values for the product's personalization fields, keyed by field key (from get_product). |
| shipping_address | object | |
| shipping_address.country | string | ISO 3166-1 alpha-2 code. Only US is shipped to. ( exactly 2 chars, default "US") |
| shipping_option | string | Shipping option id or name; defaults to the cheapest. ( ≤ 100 chars) |
| coupon_code | string | ( ≤ 50 chars) |
* required
Returns
items[]
{ handle, title, variant, selected_options, choose_on_product_page?, unit_price, quantity, line_total, personalization, product_url }
subtotal
Items before discounts
discounts[]
{ type: multi_buy | coupon, description, amount }
coupon
{ code, applied, reason? } — only when a coupon_code was sent
shipping
{ selected, options[] { id, name, price, free } }
total_before_tax
Discounted items + shipping. Sales tax is added at checkout
estimated_delivery
{ ships_by, earliest, latest }
notes[]
What the quote does and doesn't include
quoted_at
ISO 8601 timestamp
Example request: “How much are four 3-inch glossy angel cat stickers, shipped?”
Results are returned both as structuredContent and as JSON text, so older clients work too. The server also sends these instructions on initialize:
AVDEB (https://avdeb.com) is a US shop for stickers, vinyl decals, name badges, NFC keychains, 3D printed goods and personalized gifts. All tools are read-only.
Typical flow: search_products or browse_category → get_product (variants, personalization fields) → quote_order for an exact price with shipping and discounts (sales tax is added at checkout).
Orders are placed by the buyer on avdeb.com: add the items on each product page and check out at https://avdeb.com/cart (guest checkout, Stripe). Ships to US addresses only; prices in USD.
Errors
Tool result with isError: true
A fixable problem: unknown handle, missing variant or personalization, unsupported country, invalid arguments. The text explains what to change.
-32700 (HTTP 400)
Body isn't valid JSON
-32600
Not a JSON-RPC 2.0 request, request larger than the size limit (HTTP 413), or unsupported HTTP method (HTTP 405)
-32601
Method not found (only initialize, ping, tools/list and tools/call are supported)
-32602
Unknown tool name
-32603 (HTTP 500)
Unexpected server error
-32000 (HTTP 429)
Rate limit exceeded — wait for the Retry-After header
Notifications get HTTP 202 with no body. GET returns 405 because the server never opens a server-to-client stream. Quotes are never “pending”: a quote either succeeds or returns a tool error, and nothing needs to be retried or rolled back.
Limits
Requests
120 per 5 minutes per IP address
Request size
64 KB
Time per tool call
10 seconds, then a "try again" tool error
quote_order
Up to 20 lines, quantity 1–100 per line
Caching
Categories and shipping rates may be up to 5 minutes old; prices and stock are read live
Data and privacy
- No accounts, sign-in, cookies or payment details. The server can't see orders or customer data.
- It only receives what the assistant sends — search words, product choices, personalization text, coupon codes, shipping country — uses it to answer, and doesn't store it.
- Request contents are never used for advertising, profiling or AI training, and never sold.
- IP addresses are used briefly, hashed, for rate limiting. Hosting and monitoring providers record standard request metadata (time, URL, status, timing) for a limited period — never request contents.
Details: Privacy Policy — AI Assistants and Connectors.
Support and changes
Questions or problems: info@avdeb.com or the contact form. Security issues: please email us with “Security” in the subject. Tools are only ever added in a backwards-compatible way; breaking changes get a new version number here first.
Changelog
- 1.0.0 — October 22, 2026: initial release with six read-only tools.