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

https://avdeb.com/mcp

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

  1. Find products with search_products or browse_category.
  2. Read options, variants and personalization fields with get_product.
  3. Price the exact basket with quote_order — it validates every choice and applies the same discount and shipping rules as checkout.
  4. 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

NameTypeDetails
query *stringWhat the shopper is looking for, e.g. 'cat laptop sticker'. ( 2–200 chars)
limitinteger( 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

NameTypeDetails
handle *stringProduct 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

NameTypeDetails
slug *string( 1–120 chars)
pageinteger( 1–50, default 1)
page_sizeinteger( 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

NameTypeDetails
items *array of objects( 1–20 items)
items[].handle *stringProduct handle (from search_products, browse_category or get_product). ( 1–200 chars)
items[].variant_idstringVariant id from get_product. Use this or options. ( ≤ 40 chars)
items[].optionsobject (string → string)Option selections from get_product, e.g. {"Size": "3\" x 3\""}. Use this or variant_id.
items[].quantityinteger( 1–100, default 1)
items[].personalizationobject (string → string)Values for the product's personalization fields, keyed by field key (from get_product).
shipping_addressobject
shipping_address.countrystringISO 3166-1 alpha-2 code. Only US is shipped to. ( exactly 2 chars, default "US")
shipping_optionstringShipping option id or name; defaults to the cheapest. ( ≤ 100 chars)
coupon_codestring( ≤ 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.