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 Dashboard 策略引擎强制执行：

• 每笔交易限额：阻止任何超过您上限的单个调用（例如最高 $0.01）。

• 每日预算上限：防止失控的递归循环（例如每天最高 $5.00）。

• 域名白名单：仅允许代理在已验证的域名上支出。

• 人工审批触发：高价值调用会自动暂停以等待人工审批。

许可证

MIT © PayAgents