Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-agentic

saas-seo-agentic

Unverified

Audit & implement IsItAgentReady Level 0-5 standards (RFC 9727, llms.txt, MCP cards, JWKS).

references/agentic-commerce-protocols.md

View on GitHub
# Agentic Commerce & Machine Payment Protocols

Protocols allowing AI agents to discover pricing, fulfill HTTP micro-payments, and complete programmatic checkout flows on SaaS APIs and web platforms.

---

## 1. x402 Protocol (`HTTP 402 Payment Required`)

Coinbase-originated open HTTP payment standard (`x402.org`, `@x402/next`, `@x402/hono`, `@x402/express`):
- **Use case**: Pay-per-request SaaS APIs, metered inference endpoints, or premium Markdown content without API keys or monthly subscriptions.
- **Next.js Integration**: Attach `@x402/next` middleware specifying a facilitator URL, wallet address, and route pricing rules.
- **Behaviour**: Unpaid requests receive `HTTP 402 Payment Required` with machine-readable payment instructions; agents sign and resubmit automatically.

---

## 2. MPP — Machine Payment Protocol (`/openapi.json`)

OpenAPI payment discovery (`mpp.dev`, `draft-payment-discovery-00`):
- **Discovery Path**: `/openapi.json` served at site root with HTTP 200.
- **Operation Extensions**: Add `x-payment-info` on payable OpenAPI operations:
  - `intent`: `"charge"` or `"session"`
  - `method`: `"tempo"`, `"stripe"`, `"lightning"`, or `"card"`
  - `amount`: numeric or string payment amount
  - Optional: `currency`, `description`, and top-level `x-service-info` categories.

---

## 3. ACP — Agentic Commerce Protocol (`/.well-known/acp.json`)

OpenAI + Stripe agentic checkout protocol (`agenticcommerce.dev`):
- **Discovery Path**: `/.well-known/acp.json` returning HTTP 200 JSON.
- **Required Fields**:
  - `protocol`: `{ "name": "acp", "version": "1.0" }`
  - `api_base_url`: Absolute `http(s)://` URL
  - `transports`: Non-empty array (e.g., `["rest-json"]`)
  - `capabilities.services`: Non-empty array of offered commerce services (e.g., `["checkout", "subscriptions"]`).

---

## 4. UCP — Universal Commerce Protocol (`/.well-known/ucp`)

Google + Shopify open commerce specification (`ucp.dev/specification/overview/`):
- **Discovery Path**: `/.well-known/ucp` returning HTTP 200 JSON.
- **Required Fields**: `protocol_version`, `services`, `capabilities`, `endpoints`.
- All referenced spec URLs and schemas must be publicly reachable without soft-404 redirects.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall