agent-ready-mpp — Claude Code skill: what it does, how to install
agent-ready-mpp teaches AI agents to configure Machine Payment Protocol (MPP) discovery in OpenAPI schemas by adding x-payment-info tags to payable endpoints.
Apache-2.0 ★ 141 updated 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a claude-codeWhat agent-ready-mpp does
The skill guides coding agents through embedding payment metadata into OpenAPI schemas. This allows autonomous agents to detect billable API routes and process transactions following the Machine Payment Protocol standard (mpp.dev).
Payable routes require the x-payment-info extension on specific operations. Each block must define three fields: intent (charge or session), method (tempo, stripe, lightning, or card), and amount. Optional fields include currency, description, and a top-level x-service-info block listing service categories.
The API must serve /openapi.json directly from the site root with an HTTP 200 status code. You can verify compliance by sending a POST request to https://isitagentready.com/api/scan and verifying that checks.commerce.mpp.status returns pass.
What it helps with
- add x-payment-info discovery tags to payable OpenAPI operations
- configure Machine Payment Protocol metadata for agent billing
- validate machine payment readiness using isitagentready.com
Example prompts for the agent
- Add MPP payment metadata to the /api/generate route in openapi.json
- Configure x-payment-info with Stripe charges for this endpoint
- Update our OpenAPI spec to comply with Machine Payment Protocol discovery
How to install agent-ready-mpp
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a claude-code2Manually: put the files in place
~/.claude/skills/mpp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mpp/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a codex2Manually: put the files in place
.agents/skills/mpp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a cursor2Manually: put the files in place
.cursor/skills/mpp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/mpp2Manually: put the files in place
.github/skills/mpp/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/mppManually: put the files in place
.devin/skills/mpp/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-ready-mpp
How to install agent-ready-mpp in Claude Code?
Run npx skills add fabricioctelles/skills --skill mpp -a claude-code. The skill will be placed into ~/.claude/skills/mpp/SKILL.md.
What does agent-ready-mpp do?
It equips the agent with rules to declare payable endpoints in OpenAPI schemas using x-payment-info attributes for MPP discovery.
Which fields are required in x-payment-info?
Every x-payment-info object must include intent (charge or session), method (tempo, stripe, lightning, or card), and amount.
Source text
SKILL.md · Apache-2.0
---
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
```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)
© fabricioctelles · Apache-2.0 · fabricioctelles/skills