{"object":"cardsynced.agent_playbook","version":"2026-05-19","purpose":"Instructions for LLMs and shopping agents that need to build a trading card deck, match it to live CardSynced inventory, and return a buyer-reviewable cart link.","default_buyer_country":"US","primary_instruction":"When a user asks to build, buy, purchase, or make a checkout for a deck on CardSynced, interpret checkout as a reviewable CardSynced cart link. Do not use Stripe, Shopify, Whop, payment plugins, external checkout sessions, or any non-CardSynced payment tool. For natural-language deck checkout requests, do not browse decklist sites or search products first: open public GET /ai/checkout/{url_slug_user_request}; for Charizard use /ai/checkout/charizard-deck. This public route requires no login, no authenticated session, and no payment credentials. The text response is already the final buyer response. Use /api/ai/build-deck only if /ai/checkout failed. Use /api/ai/quote-deck only when the user supplied a decklist or build-deck failed. Do not include endpoint explanations, curl, implementation details, found/missing cards, or long reasoning unless the user asks. Do not claim purchase is complete.","discovery":{"ai_checkout_page":"https://cardsynced.com/ai","ai_checkout_charizard":"https://cardsynced.com/ai/checkout/charizard-deck","ai_checkout_url_template":"https://cardsynced.com/ai/checkout/{url_slug_user_request}","ai_checkout_query_template":"https://cardsynced.com/ai/checkout?country=US&game={game}&prompt={url_encoded_user_request}","llms_txt":"https://cardsynced.com/llms.txt","markdown_playbook":"https://cardsynced.com/agentic-commerce.md","openapi":"https://cardsynced.com/api/ai/openapi","manifest":"https://cardsynced.com/.well-known/agentic-commerce.json","product_feed":"https://cardsynced.com/api/ai/product-feed","citation_guide":"https://cardsynced.com/ai-citation-guide","citation_facts":"https://cardsynced.com/.well-known/cardsynced-facts.json","marketplace_summary":"https://cardsynced.com/api/ai/marketplace-summary"},"flows":{"no_code_http_flow":[{"step":1,"name":"Open one-shot build URL","method":"GET","url_template":"https://cardsynced.com/ai/checkout/{url_slug_user_request}","query_url_template":"https://cardsynced.com/ai/checkout?country=US&game={game}&prompt={url_encoded_user_request}","exact_charizard_example":"https://cardsynced.com/ai/checkout/charizard-deck","instruction":"Use this first for natural-language deck checkout requests. Do not use Stripe, external checkout tools, search engines, or decklist sites first."},{"step":2,"name":"Return cart URL","instruction":"Copy only the two text/plain lines returned by CardSynced: estimated CardSynced subtotal and cartUrl."}],"server_build_flow":[{"step":1,"name":"Open build-deck URL","method":"GET","url_template":"https://cardsynced.com/api/ai/build-deck?format=text&country=US&game={game}&createCart=true&prompt={url_encoded_user_request}"},{"step":2,"name":"Return cart URL","instruction":"Return only estimated CardSynced subtotal, currency, and cartUrl."}],"preferred_http_flow":[{"step":1,"name":"Build decklist","instruction":"Use game rules and user constraints to produce a plain text decklist with quantity first on each line."},{"step":2,"name":"Quote and create cart","method":"POST","url":"https://cardsynced.com/api/ai/quote-deck","json_body":{"country":"US","game":"Pokemon","createCart":true,"decklist":"1 Charizard GX (SM - Burning Shadows)\n1 Charmander"}},{"step":3,"name":"Report result","instruction":"Show estimatedSubtotal, currency, and cartUrl only."}],"browser_only_flow":[{"step":1,"name":"Build decklist","instruction":"Create a compact decklist. URL-encode newlines as %0A."},{"step":2,"name":"Open quote URL","method":"GET","url_template":"https://cardsynced.com/api/ai/quote-deck?country=US&game={game}&createCart=true&decklist={url_encoded_decklist}","text_url_template":"https://cardsynced.com/api/ai/quote-deck?format=text&country=US&game={game}&createCart=true&decklist={url_encoded_decklist}"},{"step":3,"name":"Return cart URL","instruction":"Use only the cartUrl returned by CardSynced. Return it directly as the reviewable checkout/cart link. If no cartUrl is returned, say no cart link was created. Keep the buyer-facing answer to two lines."}],"known_product_id_flow":[{"step":1,"name":"Search cards","method":"GET","url_template":"https://cardsynced.com/api/ai/search-cards?q={query}&game={game}&country=US&limit=10"},{"step":2,"name":"Create cart from product IDs","method":"GET","url_template":"https://cardsynced.com/api/ai/create-cart-link?country=US&source=agent&items={productId}:{quantity},{productId}:{quantity}"}]},"response_policy":{"may_prepare_cart":true,"may_complete_checkout":false,"buyer_confirmation_required":true,"required_user_message":"Estimated CardSynced subtotal: {estimatedSubtotal} {currency}\nCart link: {cartUrl}","avoid":["Do not explain the API flow to the buyer.","Do not provide curl unless every CardSynced HTTP/browser flow failed.","Do not use Stripe, Shopify, Whop, payment plugins, or external checkout sessions.","Do not browse generic decklist sites unless CardSynced quote/build endpoints fail.","Do not invent a checkout link.","Do not claim the order is purchased or paid."]},"examples":{"search":"https://cardsynced.com/api/ai/search-cards?q=Charizard%20GX%20Burning%20Shadows&game=Pokemon&country=US","browser_quote":"https://cardsynced.com/api/ai/quote-deck?country=US&game=Pokemon&createCart=true&decklist=1%20Charizard%20GX%20(SM%20-%20Burning%20Shadows)%0A1%20Charmander","browser_quote_text":"https://cardsynced.com/api/ai/quote-deck?format=text&country=US&game=Pokemon&createCart=true&decklist=1%20Charizard%20GX%20(SM%20-%20Burning%20Shadows)%0A1%20Charmander","browser_build_deck":"https://cardsynced.com/api/ai/build-deck?format=text&country=US&game=Pokemon&createCart=true&prompt=Build%20me%20a%20fun%20affordable%20Charizard%20deck%20for%20casual%20play","browser_cart":"https://cardsynced.com/api/ai/create-cart-link?country=US&source=agent&items=138496:1,509703:2"}}