PayAgents

Proporciona a los agentes de IA una billetera controlada por políticas para pagar APIs con acceso restringido por 402 en Bitcoin Lightning (L402) y Base USDC (x402), con límites de gasto por transacción y diarios.

Documentación

Servidor MCP de PayAgents (payagents-mcp)

npm version License: MIT

El servidor oficial del Protocolo de Contexto de Modelo (MCP) para PayAgents. Dale a tus agentes de IA (Claude Desktop, Cursor, Windsurf, Zed, LangChain, OpenDevin) una billetera controlada por políticas para pagar APIs y herramientas de forma autónoma a través de Bitcoin Lightning (L402) y Base USDC (x402).


⚡ Inicio rápido para Claude Desktop

Agrega payagents-mcp a tu claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "payagents": {
      "command": "npx",
      "args": ["-y", "payagents-mcp"],
      "env": {
        "PAYAGENTS_API_KEY": "pa_live_your_api_key_here"
      }
    }
  }
}

Reinicia Claude Desktop y tu asistente de IA tendrá acceso automáticamente a las herramientas de pago de PayAgents.


🛠️ Herramientas MCP disponibles

1. payagents_pay_url

Ejecuta una solicitud HTTP a cualquier endpoint de API o recurso protegido, resolviendo y pagando automáticamente los desafíos de pago HTTP 402 / L402 / x402 dentro de tus límites de gasto empresarial.

  • Parámetros:
    • url (obligatorio, cadena): URL de la API de destino.
    • method (opcional, predeterminado: "GET"): GET, POST, PUT, DELETE.
    • body (opcional, objeto/cadena): Carga útil del cuerpo de la solicitud.
    • headers (opcional, objeto): Encabezados HTTP adicionales.
    • max_amount (opcional, cadena): Monto máximo dispuesto a pagar (p. ej., "0.01 USD").

2. payagents_get_balance

Verifica el saldo de gasto disponible del agente, el nivel de suscripción y las políticas de gasto activas (límites por transacción y límites diarios).

3. payagents_get_transaction

Consulta los detalles de una transacción pasada, mostrando la vía de pago, el método de liquidación (🟢 Directo sin custodia vs Gestionado por la plataforma) y las pruebas de verificación criptográfica.


💰 Monetiza tus propias herramientas MCP

Si estás creando un servidor MCP y deseas cobrar microtarifas cuando otros agentes llamen a tus herramientas:

npm install payagents-mcp @modelcontextprotocol/sdk zod
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { mcpCharge } from 'payagents-mcp';
import { z } from 'zod';

const server = new McpServer({ name: 'weather-mcp', version: '1.0.0' });

// Gate your tool behind $0.002 micro-payment
server.tool(
  'get_forecast',
  'Retrieve real-time radar forecast data',
  { city: z.string() },
  mcpCharge({ price: '0.002 USD' }, async ({ city }) => {
    return {
      content: [{ type: 'text', text: `Forecast data for ${city}` }],
    };
  })
);

🔒 Seguridad y políticas de gasto

Todos los pagos de agentes se aplican mediante el Motor de Políticas del Panel de PayAgents:

  • Límite por transacción: Bloquea cualquier llamada individual que supere tu límite (p. ej., máximo $0.01).
  • Límite de presupuesto diario: Evita bucles de recursión descontrolados (p. ej., máximo $5.00/día).
  • Listas de dominios permitidos: Restringe el gasto del agente solo a dominios verificados.
  • Disparadores de aprobación humana: Las llamadas de alto valor se pausan automáticamente para aprobación humana.

Licencia

MIT © PayAgents