agentic-commerce-kit

Tools for converting or building stores that AI agents can shop.

Agents can't fill in a browser checkout form. To buy from a store, an agent needs a way to discover what's for sale and how to pay, and a machine payment path it can complete on its own. This repo collects the tooling to add that to any store.

The tools ship as host-agnostic skills (SKILL.md folders — plain markdown, code, and scripts) that work with any AI coding agent that loads skills, plus a universal installer and a Claude Code plugin.

Install

Quickest: paste this to your agent

Paste this prompt into any coding agent (Claude Code, Codex, Cursor, …) and let it do the install:

Clone https://github.com/stepandel/agentic-commerce-kit into a permanent location
(e.g. ~/.agentic-commerce-kit; pull latest if it already exists), then run its
./setup script to install the skills into the AI agents on this machine. Run
`./setup --list` first and show me what it detected, then run `./setup`. Confirm the
enable-agentic-shopping skill is installed and tell me how to invoke it.

Manual

Clone the repo and run the installer. It auto-detects which agents you have and symlinks the skills into each one's skills directory:

git clone https://github.com/stepandel/agentic-commerce-kit
cd agentic-commerce-kit
./setup                 # install for every detected agent

Target or inspect specific agents:

./setup --list          # show known agents and which are detected
./setup --host codex    # install for one agent
./setup --all           # install for every known agent (create dirs as needed)
./setup --copy          # copy instead of symlink (Windows / no symlink support)
./setup --uninstall     # remove the kit's skills

Supported agents: Claude Code, Codex CLI, Cursor, OpenCode, Factory Droid. Adding another is two lines — see docs/ADDING_A_HOST.md.

Re-run ./setup after git pull (symlinks track the repo; --copy installs do not).

Claude Code: install as a plugin (alternative)

/plugin marketplace add stepandel/agentic-commerce-kit
/plugin install agentic-commerce@agentic-commerce-kit

Use

In any project, ask your agent to "enable agentic shopping in <path-to-store>". On Claude Code you can also invoke it directly: /agentic-commerce:enable-agentic-shopping <path>.

What's inside

agentic-commerce-kit/
├── setup                          # universal multi-agent installer
├── skills/
│   └── enable-agentic-shopping/   # the skill (host-agnostic)
│       ├── SKILL.md
│       ├── references/            # MPP/SPT protocol, SDKs, Stripe prereqs, adapters
│       └── templates/             # the code copied into the store
├── .claude-plugin/                # Claude Code plugin + marketplace manifests
└── docs/ADDING_A_HOST.md

• enable-agentic-shopping — adds agentic shopping to an existing store. It verifies Stripe prerequisites, wires up MPP (Machine Payments Protocol) checkout over Stripe Shared Payment Tokens plus the agent discovery layer (llms.txt, agent-storefront.json, openapi.json), writes the code into the target store, and confirms the 402 payment flow works — pausing for the user at every store-specific fork. Works against any store language — MPP is HTTP-native with official SDKs in TypeScript, Python, Rust, Go, and Ruby (bundled templates are TypeScript; other languages use their SDK). Stripe-SPT-only.

Local development

Validate the Claude plugin/marketplace manifests:

claude plugin validate . --strict

Test the installer against a throwaway HOME without touching your real config:

TMP=$(mktemp -d); mkdir -p "$TMP/.codex"; HOME="$TMP" ./setup --host codex; ls "$TMP/.codex/skills"

Background

The patterns here are distilled from a reference implementation: a working agentic storefront built on the mppx SDK and Stripe Shared Payment Tokens.

License

MIT