How do I install the Acp Setup skill?

Run npx skillmds add majiayu000/acp-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Acp Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Acp Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Acp Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Acp Setup?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Acp Setup by majiayu000 — Agent Skill

Name: Acp Setup
Rating: 4.2 (5 reviews)
Author: majiayu000

Acp Setup

Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.

majiayu000 a070e50 2 files · 3.9 KB Updated Sep 9, 2026 567 repo stars

File contents

ACP Project Setup

Before writing code

Fetch the latest spec version: Web-search site:github.com agentic-commerce-protocol CHANGELOG for the current spec version
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
Fetch the get-started guide: Fetch https://developers.openai.com/commerce/guides/get-started/ for onboarding steps
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:

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

Configuration Essentials

These must be externalized (env vars or config file):

ACP_API_KEY — Bearer token for authentication
ACP_API_VERSION — Spec version (YYYY-MM-DD format)
ACP_WEBHOOK_SECRET — HMAC signing key for webhooks
STRIPE_API_KEY — If using Stripe as PSP for delegated payment
ACP_MERCHANT_ID — Merchant identifier for SPT scoping

Project Structure Pattern

merchant-server/
├── config/                  # Environment and settings
├── routes/
│   ├── checkout.py/ts       # 5 checkout endpoints
│   ├── webhooks.py/ts       # Webhook receiver
│   └── health.py/ts         # Health check
├── middleware/
│   ├── auth.py/ts           # Bearer token validation
│   ├── idempotency.py/ts    # Idempotency key handling
│   └── versioning.py/ts     # API-Version header validation
├── models/                  # Data models from JSON schema
├── services/
│   ├── checkout.py/ts       # Business logic
│   ├── payment.py/ts        # PSP integration
│   └── inventory.py/ts      # Stock management
├── schemas/                 # OpenAPI + JSON schemas
└── tests/

Fetch the OpenAPI spec for exact endpoint paths, request/response shapes, and status codes before generating stubs.

---name: acp-setupdescription: Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.--- # 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 ## Configuration Essentials These must be externalized (env vars or config file): - `ACP_API_KEY` — Bearer token for authentication - `ACP_API_VERSION` — Spec version (YYYY-MM-DD format) - `ACP_WEBHOOK_SECRET` — HMAC signing key for webhooks - `STRIPE_API_KEY` — If using Stripe as PSP for delegated payment - `ACP_MERCHANT_ID` — Merchant identifier for SPT scoping ## Project Structure Pattern ``` merchant-server/ ├── config/ # Environment and settings ├── routes/ │ ├── checkout.py/ts # 5 checkout endpoints │ ├── webhooks.py/ts # Webhook receiver │ └── health.py/ts # Health check ├── middleware/ │ ├── auth.py/ts # Bearer token validation │ ├── idempotency.py/ts # Idempotency key handling │ └── versioning.py/ts # API-Version header validation ├── models/ # Data models from JSON schema ├── services/ │ ├── checkout.py/ts # Business logic │ ├── payment.py/ts # PSP integration │ └── inventory.py/ts # Stock management ├── schemas/ # OpenAPI + JSON schemas └── tests/ ``` Fetch the OpenAPI spec for exact endpoint paths, request/response shapes, and status codes before generating stubs.

Frequently asked questions