> ## 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.

# Discovery UCP

> Il profilo Universal Commerce Protocol che un host di ordinazione storekit pubblica su /.well-known/ucp: i locali per cui vende e i loro endpoint cart MCP.

**Per chi è:** una piattaforma di commercio o un host di agenti che connette i clienti ai commercianti.

Un client [UCP](https://ucp.dev/2026-08-25/specification/overview/) legge un profilo prima di collegarsi a qualsiasi cosa: quali servizi parla un'azienda, su quale trasporto, a quale endpoint, e quali capability implementano questi endpoint. Un host di ordinazione storekit pubblica quel profilo, e gli endpoint che nomina sono gli [endpoint MCP](/docs/it/developers/agents/ordering/mcp-endpoint) rivolti al cliente.

## Percorsi

| Percorso | Risponde con |
| - | - |
| `GET https://{host}/.well-known/ucp` | Ogni locale per cui vende l'host, ciascuno come una propria voce di servizio |
| `GET https://{host}/{venueSlug}/.well-known/ucp` | Quel singolo locale |

Un host vende per molti locali e ciascuno ha il proprio endpoint MCP, quindi il profilo dell'host li elenca — con un limite di 25, come ogni altro elenco rivolto agli agent — e un agente che sta già parlando di un locale legge invece il percorso del locale. Quali locali appaiono viene dall'host stesso, quindi un brand sul proprio dominio pubblicizza le posizioni di quel brand e nient'altro.

Le risposte sono JSON, cachate per 15 minuti e aperte a qualsiasi origine. Un host senza locali, o uno slug di locale che non si risolve, è un `404`: nessun profilo batte un profilo senza endpoint al suo interno.

## Profilo

```json theme={null}
{
  "ucp": {
    "version": "2026-08-25",
    "services": {
      "dev.ucp.shopping": [
        {
          "id": "gordon-ramsay-plane-food-1",
          "version": "2026-08-25",
          "spec": "https://ucp.dev/2026-08-25/specification/overview",
          "transport": "mcp",
          "endpoint": "https://order.storekit.com/gordon-ramsay-plane-food-1/api/mcp",
          "schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
        }
      ]
    },
    "capabilities": {
      "dev.ucp.shopping.cart": [
        {
          "version": "2026-08-25",
          "spec": "https://ucp.dev/2026-08-25/specification/shopping/cart",
          "schema": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json"
        }
      ]
    },
    "payment_handlers": {}
  }
}
```

| Campo | Significato |
| - | - |
| `services["dev.ucp.shopping"]` | Una voce per locale. Le voci differiscono solo per `endpoint`, e ogni `id` è lo slug del locale che parla il resto dell'API. |
| `transport` | Solo `mcp`. È l'unico trasporto che l'host serve; il trasporto in-page di UCP è il protocollo dell'iframe embedded, che queste pagine non ascoltano. |
| `schema` | Il binding rispetto al quale un client valida le chiamate, sia sulla voce del servizio che sulla capability. |
| `capabilities["dev.ucp.shopping.cart"]` | I quattro strumenti cart sull'endpoint dichiarato: `create_cart`, `get_cart`, `update_cart`, `cancel_cart`. |
| `payment_handlers` | Dichiarato vuoto di proposito. Il pagamento viene saldato sulla pagina del locale stesso, quindi non c'è un handler contro cui una piattaforma possa tokenizzare — un oggetto vuoto dice "nessuno offerto" dove una chiave mancante si legge come un profilo incompleto. |

Ogni endpoint dichiarato risponde a una sonda `GET` con `200`, e il `robots.txt` dell'host di ordinazione nomina i crawler agent così che il percorso well-known sia inequivocabilmente permesso ad essi.


## Related topics

- [Panoramica degli agenti di ordinazione](/docs/it/developers/agents/ordering/overview.md)
- [MCP Endpoint](/docs/it/developers/agents/ordering/mcp-endpoint.md)
- [Introduzione per sviluppatori](/docs/it/developers/introduction.md)
- [Autenticazione](/docs/it/developers/mcp/authentication.md)
- [Panoramica del merchant MCP](/docs/it/developers/mcp/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.