ucp-merchant-agent

Provision a Python-based A2A shopping agent for UCP merchant interactions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/pjordan/claude-toolkit --skill ucp-merchant-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ucp-merchant-agent
Source: https://github.com/pjordan/claude-toolkit/tree/main/skills/examples/ucp-merchant-agent
Command: npx skills add https://github.com/pjordan/claude-toolkit --skill ucp-merchant-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a ready-to-use framework for building Python-based A2A agents that interact with UCP merchants, enabling automated discovery, checkout session management, and payments.

Core Features & Use Cases

  • Automated agent scaffolding: bootstrap a shopping agent capable of discovering merchants, negotiating capabilities, creating checkout sessions, and completing payments.
  • Payment workflow patterns: demonstrates Google Pay, direct tokenization, and AP2 mandates within sample handlers and templates.
  • Template-driven development: includes scaffolding scripts, reference docs, and a basic agent profile to accelerate integration with UCP commerce.

Quick Start

To scaffold a new agent from the template, run the included script and follow the on-screen steps. Example: python scripts/create_ucp_agent.py my-shopping-agent --path ./agents Then navigate to the new agent directory and start configuring environment and dependencies.

Frequently Asked Questions about ucp-merchant-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Python A2A agent for UCP merchant checkout?

You can scaffold a Python A2A agent for UCP merchant checkout by running the provided script, which generates a project template for discovering merchant capabilities, creating checkout sessions, and handling payments. The template includes FastAPI, httpx, and pydantic.

Can I automate Google Pay and 3DS payments across multiple UCP merchants?

Yes, the UCP merchant agent supports automating AP2 or 3DS payments across multiple merchants. It provides sample handlers and templates that demonstrate Google Pay, direct tokenization, and AP2 mandates within the checkout workflow.

What Python version and dependencies are required for the UCP merchant agent?

The UCP merchant agent requires Python 3.10 or higher. You also need standard libraries plus dependencies listed in the templates, specifically FastAPI, httpx, pydantic, and python-dotenv to bootstrap and run the agent.

How do I scaffold an A2A shopping agent from a template?

To scaffold an A2A shopping agent, run `python scripts/create_ucp_agent.py my-shopping-agent --path ./agents` from the project root. This script bootstraps a new agent directory with configuration files and reference docs to accelerate integration.

Does the UCP merchant agent support checkout session negotiation?

Yes, the UCP merchant agent automates checkout session negotiation. It applies to discovering merchant capabilities, negotiating terms, creating checkout sessions, and completing payments across the UCP network.

When should I use a template-driven agent for UCP commerce integration?

Use the template-driven agent when you need a ready-to-use framework for building Python-based A2A agents that interact with UCP merchants, enabling automated discovery, checkout session management, and payments without starting from scratch.