# UCP Checkout over MCP for Magento 2  -  module reference

> Add the five UCP checkout operations as MCP tools on your Magento 2 MCP server. Same sessions and results as REST; the buyer pays on your own checkout.

Source: https://angeo.dev/docs/modules/ucp-checkout-mcp/
Updated: 2026-10-17

Module reference

# UCP Checkout over MCP for Magento 2  -  module reference

Covers `angeo/module-ucp-checkout-mcp` 1.0.0 - Checked 16 October 2026 - MIT licensed

**UCP Checkout over MCP** offers the UCP checkout for agents that speak MCP instead of REST. It adds five tools to the store MCP server from [MCP Server](https://angeo.dev/docs/modules/mcp-server/), following UCP spec 2026-08-25 (MCP binding).

All the logic lives in [UCP Checkout](https://angeo.dev/docs/modules/ucp-checkout/). REST and MCP give the same results and share sessions. An agent can even mix them.

Package`angeo/module-ucp-checkout-mcp`Latest version1.0.0 (released 2026-10-14)Magento2.4.6+PHP8.1 - 8.5LicenseMIT, freeLinks[GitHub](https://github.com/angeo-dev/module-ucp-checkout-mcp) - [Packagist](https://packagist.org/packages/angeo/module-ucp-checkout-mcp) - [Changelog](https://github.com/angeo-dev/module-ucp-checkout-mcp/blob/main/CHANGELOG.md) - [Module page](https://angeo.dev/modules/ucp-checkout-mcp/)

**On this page**

1. Tools
2. Arguments
3. Requirements
4. Installation
5. FAQ
6. Related

## Tools

| Tool | What it does |

| `create_checkout` | New checkout from items, buyer, address and discount code |
| `get_checkout` | Current state, shipping options, and the order once paid |
| `update_checkout` | Full replacement of items, buyer, discount and shipping |
| `complete_checkout` | Handoff: `requires_escalation` + `continue_url`. The buyer pays on your checkout. |
| `cancel_checkout` | Cancel an open checkout |

## Arguments

```
{
  "meta": {
    "ucp-agent": { "profile": "https://platform.example/profile" },
    "idempotency-key": "550e8400-e29b-41d4-a716-446655440000"
  },
  "id": "chk_...",
  "checkout": { "line_items": [{ "item": { "id": "24-MB02" }, "quantity": 1 }] }
}
```

`meta["ucp-agent"].profile` is required. `idempotency-key` works like the REST header: the same key and body give the same answer; the same key with another body gives a tool error.

## Requirements

| Magento | 2.4.6+ (Open Source, Mage-OS or Adobe Commerce)  -  `magento/framework >=103.0.6 <104` |
| PHP | 8.1 - 8.5  -  `~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0` |
| Other angeo modules | [angeo/module-ucp](https://angeo.dev/docs/modules/ucp/) `^2.2`
[angeo/module-ucp-checkout](https://angeo.dev/docs/modules/ucp-checkout/) `^1.1`
[angeo/module-mcp-server](https://angeo.dev/docs/modules/mcp-server/) `^2.2.2` |
| PHP extensions | `json` |

## Installation

```
composer require angeo/module-ucp-checkout-mcp
bin/magento module:enable Angeo_UcpCheckoutMcp
bin/magento setup:upgrade
bin/magento setup:di:compile                # production mode only
bin/magento cache:flush
```

Then set **Stores -> Configuration -> Angeo -> UCP (Universal Commerce Protocol) -> Transport -> MCP Endpoint URL** to `https://your-store/mcp`, so the profile advertises the MCP transport next to REST. Check the tools with:

```
bin/magento angeo:mcp:tools
```

This module has no settings of its own. Session lifetime, limits and legal links come from UCP Checkout.

## FAQ

### Do I need UCP Checkout as well?

Yes. This module is a thin MCP layer. All checkout logic, limits and sessions come from UCP Checkout.

### Is it different from MCP Checkout?

Yes. MCP Checkout places guest orders with server-side limits and pay-by-link. This module follows the UCP checkout model, where the buyer always pays on your own checkout through continue_url.

### Can an agent switch between REST and MCP?

Yes. Both share the same sessions, so a checkout created over REST can be read or completed over MCP.

### How does the profile show the MCP transport?

Set the MCP Endpoint URL in the UCP Profile transport settings to your store's /mcp address. The profile then lists MCP next to REST.

## Related

- [UCP Checkout](https://angeo.dev/docs/modules/ucp-checkout/)  -  UCP checkout sessions over REST; the buyer pays on your own checkout
- [UCP Profile](https://angeo.dev/docs/modules/ucp/)  -  a signed /.well-known/ucp profile for UCP agents
- [MCP Server](https://angeo.dev/docs/modules/mcp-server/)  -  live, read-only catalog tools for AI agents over MCP
- [UCP checkout  -  definition](https://angeo.dev/ucp-checkout-definition/)
- [UCP for Magento 2  -  complete guide](https://angeo.dev/magento-ucp/)
- [All module reference pages](https://angeo.dev/docs/modules/) - [Compatibility matrix](https://angeo.dev/docs/compatibility/)

This page was written from the `README.md`, `composer.json` and `etc/*.xml` files of [tag 1.0.0](https://github.com/angeo-dev/module-ucp-checkout-mcp/tree/1.0.0), read on 16 October 2026. Settings, commands and defaults come straight from that code. If a newer release is out, the README on GitHub wins.