/mpp

name: agent-ready-mpp
description: >
  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).

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](https://mpp.dev) ([spec](https://paymentauth.org/draft-payment-discovery-00.txt)).

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

• [Machine Payment Protocol](https://mpp.dev)
• [Payment Discovery Spec](https://paymentauth.org/draft-payment-discovery-00.txt)