shelf
MCPFor developers

Every small shop.
One MCP address.

Shelf speaks the Model Context Protocol over streamable HTTP. Add one URL to Claude, ChatGPT, Cursor or your own agent and it can browse and buy from every shop here. No API key.

Directoryhttps://shelf-pinnaclecryptngs-projects.vercel.app/mcp

Want to see it first? Watch the demo agent shop →

claude_desktop_config.json
{
  "mcpServers": {
    "shelf": {
      "url": "https://shelf-pinnaclecryptngs-projects.vercel.app/mcp"
    }
  }
}

or one shop only

https://shelf-pinnaclecryptngs-projects.vercel.app/s/{slug}/mcp

Tools

find_shops

Find shops by what they sell, city or country.

query, city?, country?

search_all_products

Search every shop's products, with an optional price cap and currency.

query, max_price?, currency?

get_shop_info

Name, location, fulfilment and policies for one shop.

shop

search_products

Products, prices and stock for one shop.

shop, query?

create_checkout

Builds a PayPal order from product IDs and quantities. Returns an approval link and a server-side total.

shop, items[], buyer_note?

get_order_status

CREATED → APPROVED → PAID → SHIPPED. Only call it paid when this says PAID.

order_id

The payment rule

Agents never complete a payment. Totals always come from the shop's own prices, so a hidden instruction on a web page can't change what gets charged.

  1. 1 · Agent

    create_checkout

    Shelf prices the basket from the shop's own catalogue and opens a PayPal order.

  2. 2 · Buyer

    approve_url

    A person reviews the order in PayPal and approves it. Agents can't do this step.

  3. 3 · Shelf

    capture

    Shelf captures the payment, decrements stock and notifies the shop.

  4. 4 · Agent

    get_order_status

    Returns PAID. Only now may the agent say the order is paid.

Single-shop endpoints

Every shop also has its own MCP server, plus a feed.json and llms.txt for crawlers.