# Ordering MCP Tools Reference

import {
  McpErrorCodes,
  McpPrompt,
  McpResource,
  McpResourceTemplate,
  McpTool,
} from "../../custom/McpReference";

:::info[Preview]
This reference describes the Ordering MCP at `/mcp2`, which is in preview. The
[quickstart](./quickstart) explains how to get your server addresses.
:::

This page lists every tool, resource and prompt the Ordering MCP at `/mcp2/{partnerStem}` advertises. Descriptions,
parameters, output fields and hints are generated from the server's own `tools/list`, `resources/list` and
`prompts/list` responses, so they match what your agent receives.

How to read each tool:

- **Description** is the instruction the model reads, verbatim.
- **Hints** are the tool's MCP annotations. They tell a host how much caution a call needs; they do not restrict
  anything by themselves.
- **Widget** is the [MCP Apps](https://github.com/modelcontextprotocol/ext-apps) view the tool renders on hosts
  that support the extension. **Callable from a widget** says whether that view may call the tool itself.
- **Parameters** and **output fields** are shown as the server's schemas declare them, constraints included. A nested
  field inside an optional one is required only when that field is set, and the table says so. Output fields describe
  `structuredContent`; every result also carries a text summary for hosts that do not read structured content.
- A failed call returns `isError: true`, with `structuredContent.errorCode` and `structuredContent.agentGuidance`. The
  codes are listed under [Error codes](#error-codes).

## Fulfillment

### confirmFulfillment

<McpTool name="confirmFulfillment" />

## Discovery

### discoverStores

<McpTool name="discoverStores" />

### browseMenu

<McpTool name="browseMenu" />

### searchMenu

<McpTool name="searchMenu" />

### getItemOptions

<McpTool name="getItemOptions" />

## Cart

### addToCart

<McpTool name="addToCart" />

### viewCart

<McpTool name="viewCart" />

### updateCartItem

<McpTool name="updateCartItem" />

### removeFromCart

<McpTool name="removeFromCart" />

### clearCart

<McpTool name="clearCart" />

## Checkout

### reviewOrder

<McpTool name="reviewOrder" />

### confirmPayment

<McpTool name="confirmPayment" />

### placeOrder

<McpTool name="placeOrder" />

## Resources

Resources are read with `resources/read`. The data resources let an agent answer a question without a tool call. The
widget views are the HTML documents that hosts supporting MCP Apps render for the tools that name them.

### Saved addresses

<McpResource uri="gett://addresses" />

### Store policies

<McpResourceTemplate uriTemplate="gett://store/{storeId}/policies" />

### discoverStores view

<McpResource uri="ui://views/ext-apps/discoverStores.html" />

### browseMenu view

<McpResource uri="ui://views/ext-apps/browseMenu.html" />

### viewCart view

<McpResource uri="ui://views/ext-apps/viewCart.html" />

### reviewOrder view

<McpResource uri="ui://views/ext-apps/reviewOrder.html" />

## Prompts

Prompts are starting points a host can offer the person, for example as slash commands.

### orderFood

<McpPrompt name="orderFood" />

### findRestaurants

<McpPrompt name="findRestaurants" />

### reviewMyCart

<McpPrompt name="reviewMyCart" />

## Error codes

<McpErrorCodes />