Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/mpp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mpp/

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

Similar skills

All skills for Backend and APIs →

From the same set46

The whole set →
agent-ready-link-headers agent-ready-link-headers is a Claude Code skill that adds Link response headers to a site's homepage so AI agents can discover its API and documentation automatically. CX Codex +1 ★ 141repo stars agent-ready-markdown-negotiation agent-ready-markdown-negotiation implements Accept: text/markdown content negotiation so AI agents receive clean Markdown representations instead of raw HTML. CX Codex +1 ★ 141repo stars agent-ready-webmcp agent-ready-webmcp wires a site's actions into the WebMCP API so browser-based AI agents can find and call them. CX Codex +1 ★ 141repo stars agent-ready-ai-rules agent-ready-ai-rules is a skill that adds RFC 9309 rules for AI search and training crawlers to robots.txt, controlling page visibility in AI answers and use for model training. CX Codex +1 ★ 141repo stars agent-ready-dns-aid The agent-ready-dns-aid skill guides DNS-AID records that let agents locate endpoints through DNS. Use it when publishing SVCB or HTTPS records under _agents. CX Codex +1 ★ 141repo stars agent-ready-personal-agent-protocol agent-ready-personal-agent-protocol publishes Personal Agent Protocol (Poppy) draft 0.1 discovery metadata at /.well-known/poppy.json and validates OAuth issuer binding. CX Codex +1 ★ 141repo stars agent-ready-auth-md agent-ready-auth-md publishes an auth.md file and OAuth metadata so agents can discover how to register with a service. Kicks in when a scanner flags the authMd check as failing. CX Codex +1 ★ 141repo stars agent-ready-ard The agent-ready-ard skill guides you through publishing /.well-known/ai-catalog.json so agents can discover MCP servers, A2A agents, skills, and API tools. Use it to add resource discovery to a project. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open