agent-ready-mpp

Sub-skill: Implement MPP Payment Discovery. Publish OpenAPI with x-payment-info extensions so AI agents discover payable endpoints via Machine Payment Protocol (mpp.dev).

SKILL.md

GitHub

Implement MPP Payment Discovery

Publish an OpenAPI document with MPP payment discovery metadata so AI agents can discover your payable endpoints via the Machine Payment Protocol (spec).

Requirements

  • Serve /openapi.json at the site root with HTTP 200
  • Include x-payment-info extensions on payable operations
  • Each x-payment-info must declare intent (charge or session), method (tempo, stripe, lightning, card), and amount
  • Optionally include currency, description, and top-level x-service-info with categories

Example

{
  "openapi": "3.1.0",
  "info": { "title": "My API", "version": "1.0" },
  "paths": {
    "/api/generate": {
      "post": {
        "x-payment-info": {
          "intent": "charge",
          "method": "stripe",
          "amount": "0.01",
          "currency": "USD",
          "description": "Generate content"
        }
      }
    }
  }
}

Validate

POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}

Check that checks.commerce.mpp.status is "pass".

References