# 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: `fabricioctelles/agent-ready-mpp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fabricioctelles/agent-ready-mpp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fabricioctelles/agent-ready-mpp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: fabricioctelles (https://skillmd.com/u/fabricioctelles)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fabricioctelles/agent-ready-mpp

---

# 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

```json
{
  "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

```http
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)