agent-ready-mpp — скилл для Claude Code: что делает и как установить
Скилл agent-ready-mpp помогает внедрить Machine Payment Protocol (MPP) в OpenAPI, добавляя разметку x-payment-info для платных эндпоинтов вашего API.
Apache-2.0 ★ 141 обновлён 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a claude-codeЧто делает agent-ready-mpp
Скилл инструктирует агента по добавлению метаданных платежей в спецификацию OpenAPI версии 3.1.0. Это нужно, чтобы сторонние ИИ-агенты могли автоматически находить платные методы API и оплачивать запросы по стандарту Machine Payment Protocol (mpp.dev).
В разметку платных операций добавляется расширение x-payment-info. В нём обязательно указываются три поля: intent (charge или session), method (tempo, stripe, lightning или card) и amount. Дополнительно можно прописать currency, description и корневой блок x-service-info с категориями сервиса.
Без доступного файла /openapi.json в корне сайта со статусом HTTP 200 сканеры не смогут обнаружить метаданные. Проверить корректность публикации можно через запрос к https://isitagentready.com/api/scan, где параметр checks.commerce.mpp.status должен получить значение pass.
Какие задачи решает
- разметить платные эндпоинты в OpenAPI через x-payment-info
- настроить протокол Machine Payment Protocol для вызова API агентами
- проверить готовность API к платежам через isitagentready.com
Примеры запросов агенту
- Добавь параметры MPP для эндпоинта /api/generate в наш openapi.json
- Разметь платный маршрут генерации контента со списанием через stripe
- Настрой спецификацию OpenAPI по стандарту Machine Payment Protocol
Как установить agent-ready-mpp
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a claude-code2Вручную: положить файлы
~/.claude/skills/mpp/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mpp/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a codex2Вручную: положить файлы
.agents/skills/mpp/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a cursor2Вручную: положить файлы
.cursor/skills/mpp/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/mpp2Вручную: положить файлы
.github/skills/mpp/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mpp -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/mppВручную: положить файлы
.devin/skills/mpp/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об agent-ready-mpp
Как установить agent-ready-mpp в Claude Code?
Выполните команду npx skills add fabricioctelles/skills --skill mpp -a claude-code. Файл навыка сохранится в ~/.claude/skills/mpp/SKILL.md.
Что делает скилл agent-ready-mpp?
Он обучает агента размечать платные методы API в спецификации OpenAPI с помощью расширения x-payment-info для протокола Machine Payment Protocol.
Какие параметры обязательны в блоке x-payment-info?
Обязательно указывать тип intent (charge или session), поддерживаемый платёжный метод method (tempo, stripe, lightning или card) и значение amount.
Исходный текст
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