# Universal-Commerce-Protocol/ucp

Specification and documentation for the Universal Commerce Protocol (UCP)

Repository: https://github.com/Universal-Commerce-Protocol/ucp
Canonical: https://ross.abutalabs.com/products/ucp
Homepage: https://ucp.dev
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2026-08-25T18:54:10+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 87, longevity 17
- inputs: {"age_days": 246, "days_push": 8, "days_rel": 8, "gap_med": 75, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3334, forks 450 (observed 2026-08-28T04:07:56.563864+00:00)

## What it is
The Universal Commerce Protocol (UCP) is an open standard and specification for interoperable, agentic commerce, defining capabilities like checkout, order, and identity linking so AI agents, platforms, businesses, and payment providers can transact without custom integrations. This repository hosts the specification, JSON schemas, documentation, and Python tooling for implementing the protocol.

## Use cases
- implement agentic checkout for an online store
- let AI shopping agents discover and purchase from merchants
- add secure AI-agent payment authorization with AP2 mandates
- declare commerce capabilities for autonomous platform discovery
- build a payment provider integration for agent-led transactions
- standardize checkout APIs across multiple commerce platforms

## When to choose
- you want your business or platform to support AI-agent-driven commerce
- you need a standardized, vendor-neutral checkout and order protocol
- you're building payment or credential services for agentic transactions
- you want interoperability with major industry backers like Google, Shopify, and Stripe

## When to avoid
- you need a simple traditional e-commerce storefront without agent integration
- your commerce flows are entirely internal with no third-party interoperability needs
- you require a fully settled, frozen standard - UCP is still evolving rapidly

## Facets
- artifact type: library
- maturity: active
- function: api-framework, sdk, auth, security, documentation
- domain: e-commerce, apis, large-language-models, fintech
- platform: python, cross-platform, cloud
- tags: agentic-commerce, open-standard, protocol-specification, checkout, payments, ap2, json-schema, interoperability, ai-agents, web-server

## Member repositories
- Universal-Commerce-Protocol/ucp (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:56.563864+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:41:26.831260+00:00, confidence not recorded.
  - readme: https://github.com/Universal-Commerce-Protocol/ucp (fetched 2026-08-28T04:07:56.563864+00:00, sha 06e7cf22115a)
  - homepage: https://ucp.dev (fetched 2026-08-29T09:34:31.605996+00:00, sha 7cf977c6192c)
  - site_page: https://ucp.dev/documentation/core-concepts (fetched 2026-08-29T09:34:31.608759+00:00, sha 84103c643889)
  - site_page: https://ucp.dev/documentation/ucp-and-ap2 (fetched 2026-08-29T09:34:31.610937+00:00, sha cd7f8d3b2cd2)
  - site_page: https://ucp.dev/documentation/roadmap (fetched 2026-08-29T09:34:31.612583+00:00, sha 53cadbe55104)
  - site_page: https://ucp.dev/documentation/schema-authoring (fetched 2026-08-29T09:34:31.614213+00:00, sha 2c736f0d0baf)
  - site_page: https://ucp.dev/documentation/announcements (fetched 2026-08-29T09:34:31.616888+00:00, sha 4205b5cb05b1)
- Data as of 2026-08-30T08:39:29.467469+00:00.