> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ordering Agents Overview

> How a customer's AI agent orders from a storekit store: WebMCP tools in their browser, a remote MCP endpoint for assistants, UCP discovery for commerce platforms, and llms.txt for crawlers.

Everything in this section faces the customer. The agent is buying lunch on someone's behalf, so it has to answer the same questions the customer does: which venue, what is on the menu, what does it cost, is it available now. storekit answers those questions over four surfaces, each read by a different kind of customer-side agent. This page is the map; each surface has its own reference page.

Nothing here is for the restaurant's own side of the counter. At their most permissive these surfaces read a public menu and fill a basket; they do not change a menu, see an order queue or touch a store's settings, and no credential on this page grants any of that.

## Which Surface You Want

<CardGroup cols={2}>
  <Card title="WebMCP tools" icon="window" href="/docs/developers/agents/ordering/webmcp">
    An agent inside the customer's browser, on the page they are looking at.
  </Card>

  <Card title="MCP endpoint" icon="plug" href="/docs/developers/agents/ordering/mcp-endpoint">
    An assistant somewhere else — ChatGPT, Claude, an IDE — talking to a venue.
  </Card>

  <Card title="UCP discovery" icon="magnifying-glass" href="/docs/developers/agents/ordering/ucp">
    A commerce platform that reads a profile before it connects to anything.
  </Card>

  <Card title="llms.txt" icon="file-lines" href="/docs/developers/agents/ordering/llms-txt">
    A crawler that wants plain text instead of a JavaScript app.
  </Card>
</CardGroup>

Every reader below is acting for the customer, never for the restaurant:

| Surface       | The reader                        | Where it runs   | Transport                           |
| ------------- | --------------------------------- | --------------- | ----------------------------------- |
| WebMCP tools  | The customer's own browser agent  | In the open tab | `document.modelContext`, no network |
| MCP endpoint  | A remote assistant or agent app   | Anywhere        | JSON-RPC over HTTP `POST`           |
| UCP discovery | A commerce platform or agent host | Anywhere        | Cached JSON over HTTP `GET`         |
| llms.txt      | An LLM crawler                    | Anywhere        | Plain text over HTTP `GET`          |

The first two share the shaping and pricing rules, so a burger is described, priced and refused on the same grounds whichever one asks — but they are not the same tools. Their names, arguments and writes differ, and a client cannot swap one for the other: WebMCP reads the page the customer has open and writes to the basket in front of them, while the MCP endpoint reads the public API and builds a cart that outlives the call.

## What a Customer's Agent Can and Cannot Do

On the two tool surfaces, reads need no credential and writes stop before money. UCP discovery and `llms.txt` are narrower: a profile and a plain-text snapshot, not tools.

Over the WebMCP and MCP tools:

* An agent can read a venue, its menu, an item's option groups, the ordering methods it accepts and whether it is open. Remaining time slots are an MCP endpoint read only.
* An agent can put items in a basket or a cart, change quantities and choose a fulfillment method.
* An agent cannot pay. There is no checkout tool, no Pay at Table settlement and no discount handling. The customer opens the venue page to review the basket and pay, and a cart built through the MCP endpoint comes back with a link for exactly that.
* An agent is never handed customer records. Nothing on these surfaces reads or stores an account, an address book or an order history.
* An agent cannot act as the restaurant. There is no tool for editing a menu, snoozing an item, reading the order queue or changing store settings — those are the operator's, through the [dashboard](https://dashboard.storekit.com) and the [webhooks and REST API](/docs/developers/introduction).

Read tools carry MCP's `readOnlyHint` annotation and basket writes do not, which is what lets a well-behaved client call a read on its own and ask the customer before a write.

## Current Status

<Note>
  These surfaces are early. Treat the tool names and payload shapes as unstable until a page says otherwise, and expect the WebMCP half to move with the standard it follows.
</Note>

| Surface       | Status                                                                                                   |
| ------------- | -------------------------------------------------------------------------------------------------------- |
| WebMCP tools  | Live on `order.storekit.com` under a Chrome origin trial, enabled per account by storekit, Chromium-only |
| MCP endpoint  | Live for every venue and brand on the ordering host, read tools plus the UCP cart tools                  |
| UCP discovery | Live, UCP `2026-08-25`, declaring the MCP transport and the cart capability                              |
| llms.txt      | Live for the platform, every brand and every venue                                                       |

## For the Restaurant Side

A staff-facing interface — an assistant a restaurant's own team can ask about its orders and menu — is a separate piece of work and is not documented yet. When it arrives it will be its own section under Developers, on its own paths, because it answers to the restaurant rather than to a customer and is credentialled accordingly. Nothing on the four pages above changes when it lands.

Building against any of these, or want them turned on for your stores? [Contact support](/docs/getting-started/contact-support), or use the [storekit MCP/API Access Request](https://t09czsyu90l.typeform.com/to/G6rIJWNv) form if you also need the [REST API](/docs/developers/introduction#requesting-api-access).


## Related topics

- [Developer Introduction](/docs/developers/introduction.md)
- [Menu Overview](/docs/guides/menu/overview.md)
- [Orders Overview](/docs/guides/orders/overview.md)
- [WebMCP Tools](/docs/developers/agents/ordering/webmcp.md)
- [MCP Endpoint](/docs/developers/agents/ordering/mcp-endpoint.md)
