← Back to Skills Marketplace
ichiorca

Ucp Checkout Mcp

by Rohit Bajaj · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
75
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ucp-checkout-mcp
Description
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...
README (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:

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

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

  1. Authenticate (Shopify uses OAuth2 client_credentials for access tokens)
  2. Connect to the MCP endpoint
  3. Call tools with proper _meta.ucp.profile and checkout payloads
  4. 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
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
cryptocan-make-purchases
Capability Assessment
ℹ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ucp-checkout-mcp
  3. After installation, invoke the skill by name or use /ucp-checkout-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug ucp-checkout-mcp
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 75 downloads so far.

How do I install Ucp Checkout Mcp?

Run "/install ucp-checkout-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ucp Checkout Mcp free?

Yes, Ucp Checkout Mcp is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ucp Checkout Mcp support?

Ucp Checkout Mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ucp Checkout Mcp?

It is built and maintained by Rohit Bajaj (@ichiorca); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments