ACP Project Setup

Before writing code

1. Fetch the latest spec version: Web-search site:github.com agentic-commerce-protocol CHANGELOG for the current spec version
2. Fetch the OpenAPI specs: Fetch from https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/tree/main/spec — download the latest versioned checkout and delegate-payment OpenAPI YAML files
3. Fetch the get-started guide: Fetch https://developers.openai.com/commerce/guides/get-started/ for onboarding steps
4. Check for SDK packages: Search PyPI for agentic-commerce-protocol and npm for ACP-related packages. Note: there is no official standalone SDK — most implementations use the OpenAPI spec directly or reference implementations like Medusa.js

What This Skill Does

Scaffolds a new ACP merchant server project:

1. Detect language/framework — Python (FastAPI/Flask/Django), TypeScript (Express/Fastify/Medusa), Go, etc.
2. Install dependencies — HTTP framework, JSON schema validation, HMAC library, UUID generation
3. Import OpenAPI spec — Download the latest versioned spec from the GitHub repo
4. Create configuration — Environment variables for API keys, webhook secrets, API version, PSP credentials
5. Stub endpoints — Create route stubs for the 5 checkout operations + webhook receiver
6. Set up middleware — Bearer token auth, idempotency key extraction, API version header validation, request logging