Payload Sample MCP Server

Servidor MCP de Muestra de Payload

Un servidor MCP real e instalable (SDK oficial de Python de mcp, transporte stdio) que demuestra el mecanismo central del Kit de Monetización MCP de pago de Payload: medición por llamada de herramienta con una cuota gratuita, y luego una respuesta PAYMENT_REQUIRED legible por máquina una vez que la cuota se agota.

Software pequeño que se gana su sustento.

Qué hace

Herramienta	Nivel	Qué hace
word_count	GRATIS, ilimitado	Cuenta palabras, caracteres y líneas del texto de entrada.
summarize	PREMIUM	Resumen extractivo ingenuo del texto.
extract_keywords	PREMIUM	Extracción ingenua de palabras clave del texto.

El mecanismo de cuota gratuita

Las herramientas premium tienen una cuota gratuita (por defecto 5 llamadas, variable de entorno PAYLOAD_FREE_QUOTA). Después de eso, el servidor responde con un payload JSON PAYMENT_REQUIRED legible por máquina estilo x402 — no se bloquea y no recopila ningún pago real:

{
  "status": "PAYMENT_REQUIRED",
  "tool": "summarize",
  "free_quota": 5,
  "premium_calls_used": 5,
  "upgrade_url": "https://payloadtools.gumroad.com/l/mcp-monetization-kit",
  "message": "Free quota exhausted (5/5 premium calls used). Attach payment to continue, or get the full MCP Monetization Kit to collect real per-call USDC payments with the x402 flow: ..."
}

Un límite máximo (por defecto 200 llamadas totales, variable de entorno PAYLOAD_HARD_CAP) evita que esta muestra se use como un servicio gratuito. La medición está en memoria y se reinicia en cada reinicio.

Instalación y ejecución

Requiere Python 3.10+.

pip install payload-sample-mcp-server
payload-sample-mcp-server

Úsalo en Claude Desktop

Agrega a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "payload-sample": {
      "command": "payload-sample-mcp-server"
    }
  }
}

Úsalo en Cursor

Agrega a tu configuración de MCP de Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "payload-sample": {
      "command": "payload-sample-mcp-server"
    }
  }
}

Para ejecutar desde el código fuente en su lugar:

git clone https://github.com/Payloadhq/payload-sample-mcp-server
cd payload-sample-mcp-server
pip install -e .
payload-sample-mcp-server

Lo que falta deliberadamente (los kits de pago)

Esta muestra demuestra que el mecanismo de monetización funciona. No reemplaza los productos de pago:

• Recopilación de pagos reales. El Kit de Monetización MCP ($69) recopila pagos reales de USDC por llamada mediante el flujo x402, con dos verificadores (verificador HMAC de desarrollo para pruebas, verificador facilitador para producción) — sin custodia, verifica el pago y luego ejecuta tu herramienta. Incluye un registro de herramientas de pago (registerTool / callTool / listTools) con precios por herramienta, lógica de cuota gratuita, un libro de contabilidad de uso de solo anexión, el adaptador oficial del SDK sobre el transporte stdio, 15 pruebas automatizadas y un servidor de ejemplo funcional y un cliente de ejemplo que paga.
• Refuerzo de seguridad. La muestra está intencionalmente sin autenticación. La Auditoría de Preparación para el Lanzamiento de MCP ($79) te brinda un escáner de 48 reglas con correcciones concretas, plantillas de servidor reforzadas (Python y TypeScript) con autenticación de token portador, alcances y límites de velocidad por herramienta, un arnés de prueba de estrés de confiabilidad, un verificador de preparación para el despliegue, integración de CI, un conjunto de regresión y un informe de auditoría PDF con marca.
• APIs de pago sobre x402. El Kit de Inicio de API de Pago x402 ($79) cobra a los agentes de IA por llamada de API en USDC: middleware de rutas de pago, generador de manifiesto /.well-known/x402, verificadores HMAC y facilitador, libro de contabilidad de uso de solo anexión, servidor de ejemplo funcional, 9 pruebas automatizadas. Sin custodia por diseño.

Ecosistema de Payload

• Todos los productos de Payload — https://payloadtools.gumroad.com
• Más repositorios de Payload — https://github.com/Payloadhq

Soporte: kylers.partners@gmail.com · "Software pequeño que se gana su sustento."

Licencia

MIT — consulta LICENSE.