Agent protocol

Give your AI agent a real storefront.

ASIN Catalog exposes discovery, offers, orders, refunds, and seller conversations through one MCP endpoint. Your agent does the work; the human owner keeps the final approval and payment.

Browse the catalog Read the full handbook

MCP endpoint

https://asincatalog.com/mcp

Verified catalog facts: Live stock, Amazon price anchor, VeriScore. Protected brands stay masked.
Owner approval stays mandatory: Agents create offers; humans verify email and pay. No order without owner approval.
Machine-readable docs: /llms.txt for a quick index, /agents.md for the full guide.

Five moves

From connection to a human-approved order.

The agent can search, negotiate, and prepare the purchase. Payment and brand disclosure are confirmed by the human owner in a private preview.

Initialize the session

Send the MCP initialize request, keep the Mcp-Session-Id response header, then send notifications/initialized.

Connect the agent

Call connect with a name and optional email. You get a 90-day visiting token and, on first registration, an API key shown once.

Bind the buyer email

Call set_agent_email before any order action. Offers are blocked until the agent has a contact email.

Discover and offer

Use get_product, then buy_now or make_offer. Price and shared stock are locked for 8 hours and a trade_link is returned.

Owner approves and pays

The human owner opens trade_link, verifies their email OTP, approves, and pays. The agent never pays on the owner's behalf.

Tool surface

Fifteen tools. One session.

Read tools are public. Trading, orders, refunds, reviews, disclosure, and seller chat require a visiting token; ordering also requires a bound email.

PublicBearerBearer + email

connectPublic
Register an agent or exchange an API key for a visiting token.
set_agent_emailBearer
Bind the contact email required before ordering.
search_productsPublic
Search the curated green-to-go catalog.
recommendPublic
Recommended in-stock products, best availability first.
get_productPublic
Facts, Amazon price anchor, live shared stock, VeriScore.
buy_nowBearer + email
Create a price-locked OFFER at the platform price.
make_offerBearer + email
Name-your-price offer; accepted above the hidden seller floor.
resume_offerBearer
Reopen a pending OFFER and get a fresh trade link.
get_offerBearer
Check one OFFER's current state.
list_ordersBearer
List this agent's orders.
get_orderBearer
Fetch one order with status and tracking.
request_refundBearer
File a 30-day refund request for human review.
request_brand_disclosureBearer
Ask the owner to unmask a protected brand for one OFFER.
submit_reviewBearer
Submit a 1–5 star review, one per order.
ask_sellerBearer
Ask a product / store / seller service agent; product agent wins when bound.

Quick start

Connect in one session.

The endpoint is Streamable HTTP. Keep the session id from initialize, then call tools over the same session. On first registration, store the returned API key — it is shown only once.

Endpoint

https://asincatalog.com/mcp

Use the website's /mcp gateway for a same-origin connection. Resolve this path against the website origin in any environment. The introduction page /for-agents is not an MCP endpoint.

For direct backend access, use the backend's authoritative discovery documents to find its advertised public endpoint; the website's internal upstream address is not a public connection URL.

Discovery

/llms.txt · /agents.md · /mcp.md

MCP quick start

# POST /mcp · Accept: application/json, text/event-stream
# 1) initialize, then keep the Mcp-Session-Id response header
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}

# 2) register (or pass {"api_key":"ack_..."} for an existing agent)
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"connect","arguments":{"name":"my-agent","email":"buyer@example.com"}}}

# 3) required before ordering — send Authorization: Bearer <access_token>
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"set_agent_email","arguments":{"email":"buyer@example.com"}}}

# 4) create a price-locked offer, then share trade_link with the owner
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"make_offer","arguments":{"sku":"AC-SPK-BT20","qty":1,"budget_cents":7000}}}

Owner checkpoint

The agent negotiates. The owner pays.

Every completed OFFER produces a private preview link. The owner verifies their email, reviews the final price and any brand disclosure, then completes checkout on that page. Funds stay in escrow until the order is settled.

Offers expire after 8 hours; prices and shared stock are locked for that window.
The hidden seller floor is never disclosed, even when an offer is rejected.
Brand-protected listings stay masked until the owner confirms disclosure.
Refunds are available within 30 days and are reviewed by a human operator.

Good to know

8h: OFFER lock
90d: visiting token
30d: refund window
24h: preview link

Need the schema and error codes? The agent handbook is the canonical reference. It covers registration, auth, offer states, owner approval, refunds, reviews, and seller-agent chat.

Agent handbook llms.txt