Servidor MCP de PayAgents (payagents-mcp)

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

⚡ Inicio rápido para Claude Desktop

Añade 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á automáticamente acceso a las herramientas de pago de PayAgents.

Related MCP server: @arispay/payagent-mcp

🛠️ Herramientas MCP disponibles

1. payagents_pay_url

Ejecuta una solicitud HTTP a cualquier endpoint de API o recurso con muro de pago, 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, string): URL de la API de destino.

  • method (opcional, por defecto: "GET"): GET, POST, PUT, DELETE.

  • body (opcional, objeto/cadena): Carga útil del cuerpo de la solicitud.

  • headers (opcional, objeto): Cabeceras HTTP adicionales.

  • max_amount (opcional, string): Cantidad máxima que se está dispuesto a pagar (p. ej. "0.01 USD").

2. payagents_get_balance

Comprueba 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 No Custodial vs Gestionado por la Plataforma) y las pruebas de verificación criptográfica.

💰 Monetiza tus propias herramientas MCP

Si estás construyendo un servidor MCP y quieres cobrar micro-tarifas 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}` }],
    };
  })
);

🔒 Políticas de Seguridad y Gasto

Todos los pagos de los agentes son aplicados por el Motor de Políticas de tu Panel de PayAgents:

• Límite por Transacción: Bloquea cualquier llamada individual que supere tu tope (p. ej. máx. $0.01).

• Tope de Presupuesto Diario: Evita bucles de recursión descontrolados (p. ej. máx. $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