PayAgents

Dê aos agentes de IA uma carteira controlada por políticas para pagar APIs protegidas por 402, via Bitcoin Lightning (L402) e Base USDC (x402), com limites de gasto por transação e diários.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP PayAgents (payagents-mcp)

npm version License: MIT

O servidor oficial Model Context Protocol (MCP) para PayAgents. Dê aos seus agentes de IA (Claude Desktop, Cursor, Windsurf, Zed, LangChain, OpenDevin) uma carteira controlada por políticas para pagar por APIs e ferramentas de forma autônoma em Bitcoin Lightning (L402) e Base USDC (x402).

⚡ Início rápido para Claude Desktop

Adicione payagents-mcp ao seu 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"
      }
    }
  }
}

Reinicie o Claude Desktop, e seu assistente de IA terá automaticamente acesso às ferramentas de pagamento do PayAgents!

🛠️ Ferramentas MCP Disponíveis

1. payagents_pay_url

Executa uma requisição HTTP para qualquer endpoint de API ou recurso protegido por paywall, resolvendo e pagando automaticamente desafios de pagamento HTTP 402 / L402 / x402 dentro dos seus limites de gastos empresariais.

  • Parâmetros:
    • url (obrigatório, string): URL da API de destino.
    • method (opcional, padrão: "GET"): GET, POST, PUT, DELETE.
    • body (opcional, objeto/string): Corpo da requisição.
    • headers (opcional, objeto): Cabeçalhos HTTP adicionais.
    • max_amount (opcional, string): Valor máximo que deseja pagar (ex.: "0.01 USD").

2. payagents_get_balance

Verifica o saldo de gastos disponível do agente, o nível de assinatura e as políticas de gastos ativas (limites por transação e limites diários).

3. payagents_get_transaction

Consulta detalhes de uma transação passada, mostrando o canal de pagamento, o método de liquidação (🟢 Direto Não-Custodial vs Gerenciado pela Plataforma) e provas de verificação criptográfica.

💰 Monetizando Suas Próprias Ferramentas MCP

Se você está construindo um servidor MCP e deseja cobrar microtaxas quando outros agentes chamarem suas ferramentas:

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}` }],
    };
  })
);

🔒 Segurança e Políticas de Gastos

Todos os pagamentos de agentes são controlados pelo Mecanismo de Políticas do seu Painel PayAgents:

  • Limite por Transação: Bloqueie qualquer chamada individual que exceda seu teto (ex.: máx. $0,01).
  • Limite Diário de Orçamento: Evite loops de recursão descontrolados (ex.: máx. $5,00/dia).
  • Listas de Domínios Permitidos: Restrinja os gastos do agente apenas a domínios verificados.
  • Gatilhos de Aprovação Humana: Chamadas de alto valor são pausadas automaticamente para aprovação humana.

Licença

MIT © PayAgents