PayAgents MCP Server (payagents-mcp)

PayAgents를 위한 공식 Model Context Protocol (MCP) 서버입니다. AI 에이전트(Claude Desktop, Cursor, Windsurf, Zed, LangChain, OpenDevin)에게 정책 기반 지갑을 제공하여 Bitcoin Lightning (L402) 및 **Base USDC (x402)**를 통해 API와 도구 비용을 자율적으로 지불할 수 있게 합니다.

⚡ Claude Desktop 빠른 시작

payagents-mcp를 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"
      }
    }
  }
}

Claude Desktop을 다시 시작하면 AI 어시스턴트가 자동으로 PayAgents 결제 도구에 액세스할 수 있습니다!

Related MCP server: @arispay/payagent-mcp

🛠️ 사용 가능한 MCP 도구

1. payagents_pay_url

모든 API 엔드포인트 또는 유료 리소스에 HTTP 요청을 실행하고, 기업 지출 한도 내에서 HTTP 402 / L402 / x402 결제 챌린지를 자동으로 해결하고 지불합니다.

• 매개변수:

  • url (필수, 문자열): 대상 API URL.

  • method (선택, 기본값: "GET"): GET, POST, PUT, DELETE.

  • body (선택, 객체/문자열): 요청 본문 페이로드.

  • headers (선택, 객체): 추가 HTTP 헤더.

  • max_amount (선택, 문자열): 지불할 최대 금액 (예: "0.01 USD").

2. payagents_get_balance

에이전트의 사용 가능한 지출 잔액, 구독 등급, 활성 지출 정책(거래당 상한 및 일일 한도)을 확인합니다.

3. payagents_get_transaction

과거 거래의 세부 정보를 조회하여 결제 레일, 결제 방법(🟢 직접 비수탁 vs 플랫폼 관리), 암호화 검증 증명을 표시합니다.

💰 나만의 MCP 도구 수익화

MCP 서버를 구축 중이고 다른 에이전트가 도구를 호출할 때 소액 수수료를 청구하려면:

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

🔒 보안 및 지출 정책

모든 에이전트 결제는 PayAgents 대시보드 정책 엔진에 의해 시행됩니다:

• 거래당 한도: 상한을 초과하는 개별 호출을 차단합니다 (예: 최대 $0.01).

• 일일 예산 상한: 통제 불능 재귀 루프를 방지합니다 (예: 일일 최대 $5.00).

• 도메인 허용 목록: 에이전트 지출을 검증된 도메인으로만 제한합니다.

• 인간 승인 트리거: 고액 호출은 자동으로 일시 중지되어 인간의 승인을 받습니다.

라이선스

MIT © PayAgents