← 返回 Skills 市场

Ucp Checkout Mcp

Name: Ucp Checkout Mcp
Author: ichiorca

作者 Rohit Bajaj · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install ucp-checkout-mcp

功能描述

Implement UCP Checkout over the MCP (Model Context Protocol) binding — expose checkout operations as MCP tools for AI agents. Use when building an MCP server...

使用说明 (SKILL.md)

UCP Checkout — MCP Binding

Before writing code

Fetch live spec: Web-search site:ucp.dev specification checkout-mcp and fetch the page for exact tool definitions, JSON-RPC envelope format, and _meta requirements.

For Shopify's production MCP server, fetch https://shopify.dev/docs/agents/checkout/mcp for auth flow and endpoint details.

Conceptual Architecture

How MCP Maps to UCP

UCP over MCP is a 1:1 mapping of checkout operations to MCP tools using JSON-RPC 2.0. The same data model as REST, different envelope.

Five MCP Tools

MCP Tool Name	Maps To	Key Inputs
`create_checkout`	POST /checkout-sessions	checkout object + idempotency_key
`get_checkout`	GET /checkout-sessions/{id}	id
`update_checkout`	PUT /checkout-sessions/{id}	id + checkout object
`complete_checkout`	POST .../complete	id + payment_data + idempotency_key
`cancel_checkout`	POST .../cancel	id + idempotency_key

Meta Requirements

Every MCP tool call MUST include _meta.ucp.profile pointing to the platform's UCP profile URI. This replaces the UCP-Agent HTTP header from the REST binding.

Error Mapping

UCP errors embed inside JSON-RPC 2.0 error responses:

JSON-RPC error.code: -32603 (Internal Error)
JSON-RPC error.data: Contains an errors[] array, where each error has code, message, severity, and details fields

When to Use MCP Binding

You're building a merchant MCP server that AI agents (Claude, Gemini, etc.) call via tool use
You're integrating with an existing MCP server (e.g., Shopify's)
You want AI agents to autonomously browse and purchase without REST client code

Implementation Guidance

Building a Business MCP Server:

Implement the 5 tools using your MCP framework (e.g., @modelcontextprotocol/sdk for Node, mcp for Python)
Extract _meta.ucp.profile from every tool call for negotiation
Return checkout objects as JSON in the MCP tool result
Return errors using JSON-RPC error format with UCP data payload
Implement idempotency on create and complete tools

Connecting to an existing MCP server (e.g., Shopify):

Authenticate (Shopify uses OAuth2 client_credentials for access tokens)
Connect to the MCP endpoint
Call tools with proper _meta.ucp.profile and checkout payloads
Parse tool results for checkout status and messages

Shopify MCP Integration

Shopify provides a production MCP server for UCP checkout. Before implementing:

Fetch https://shopify.dev/docs/agents/checkout/mcp for the latest auth flow, endpoint URL format, and error codes
Authentication uses POST https://api.shopify.com/auth/access_token with client credentials
MCP endpoint is POST https://{shop-domain}/api/ucp/mcp

安全使用建议

Review this skill carefully before use in any real checkout system. It is not hiding code, but it documents high-impact commerce tools; only install or follow it if you can enforce human confirmation before purchases, protect Shopify credentials, and secure the MCP endpoint and payment data flows.

功能分析

Type: OpenClaw Skill Name: ucp-checkout-mcp Version: 1.0.0 The skill bundle consists of documentation and architectural guidance for implementing the Universal Checkout Protocol (UCP) via the Model Context Protocol (MCP). It contains no executable code and directs the AI agent to legitimate developer resources (shopify.dev and ucp.dev) for API specifications. There are no indicators of malicious intent, data exfiltration, or harmful prompt injection.

能力标签

cryptocan-make-purchases

能力评估

ℹ Purpose & Capability

The stated purpose, UCP Checkout over MCP, matches the documented checkout tools and Shopify integration; however, checkout and payment operations are financially sensitive.

⚠ Instruction Scope

The instructions describe autonomous agent purchasing and include a purchase-completion tool using payment data, but they do not specify human confirmation, spending limits, authorization checks, or safe failure handling before completing orders.

ℹ Install Mechanism

There is no install script or local code, but the skill tells implementers to fetch live specifications from the web, so users should verify the fetched pages are official and current.

ℹ Credentials

Shopify OAuth client credentials and provider endpoints are expected for this integration, but any credentials should be scoped and kept out of model-visible context.

✓ Persistence & Privilege

No artifact shows persistence, background execution, self-propagation, protected-path writes, or local credential-store access.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install ucp-checkout-mcp
安装完成后，直接呼叫该 Skill 的名称或使用 /ucp-checkout-mcp 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of the ucp-checkout-mcp skill. - Exposes five UCP Checkout operations as MCP tools for AI agent integration. - Documents exact mapping of REST endpoints to MCP tool names and input requirements. - Specifies meta, error mapping, and envelope format per live UCP/MCP specification. - Includes guidance for both implementing an MCP server and connecting to providers like Shopify.

元数据

Slug ucp-checkout-mcp

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Ucp Checkout Mcp 是什么？

Implement UCP Checkout over the MCP (Model Context Protocol) binding — expose checkout operations as MCP tools for AI agents. Use when building an MCP server... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 75 次。

如何安装 Ucp Checkout Mcp？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install ucp-checkout-mcp」即可一键安装，无需额外配置。

Ucp Checkout Mcp 是免费的吗？

是的，Ucp Checkout Mcp 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Ucp Checkout Mcp 支持哪些平台？

Ucp Checkout Mcp 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Ucp Checkout Mcp？

由 Rohit Bajaj（@ichiorca）开发并维护，当前版本 v1.0.0。