PayPls MCP Server

PayPls MCP服务器

MCP（模型上下文协议）服务器，使AI代理能够通过以下方式管理比特币和USDC支付 PayPls.

🏆 专为2026年USDC黑客马拉松打造 — 查看提交

这是什么？

⚠️ 重要提示： 此MCP服务器不强制执行支出限制或批准要求。 所有限额均由PayPls后端配置和执行。在中配置您的限制 PayPls仪表板 在让代理人获得真实资金之前。

该服务器允许像Claude这样的AI助手：

• 💰 检查钱包余额（BTC和USDC）
• 📤 在人工批准的情况下发送付款
• 📥 生成接收地址
• 🔍 跟踪交易状态

所有交易都可以配置为在超过一定阈值时需要人工批准，让您能够控制，同时为小额支付启用人工智能自主。

快速链接

安装

npm install -g @paypls/mcp-server

或者直接使用npx运行：

npx @paypls/mcp-server

配置

1.获取您的API代币

注册地址： paypls.io （或 test.paypls.io 用于测试网），并在设置中生成API令牌→ API密钥。

2.设置环境变量

# Required: Your PayPls API token (starts with pp_)
PAYPLS_TOKEN=pp_your_token_here

# Optional: API URL (defaults to https://api.paypls.io)
# For testnet, use: https://paypls-api-dev.nfwalls.workers.dev
PAYPLS_API_URL=https://api.paypls.io

3.配置克劳德桌面

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "paypls": {
      "command": "npx",
      "args": ["@paypls/mcp-server"],
      "env": {
        "PAYPLS_TOKEN": "pp_your_token_here"
      }
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "paypls": {
      "command": "paypls-mcp",
      "env": {
        "PAYPLS_TOKEN": "pp_your_token_here"
      }
    }
  }
}

可用工具

示例用法

配置后，您可以向Claude询问以下问题：

• “我的比特币余额是多少？”
• “向tb1q…发送10000个sat用于API订阅”
• “向0x汇款25美元…用于设计工作”
• “为我的钱包生成接收地址”
• “检查交易abc-123的状态”

安全

• 人工审批：在PayPls仪表板中配置自动批准限额。超过限额的交易需要通过Telegram明确批准。
• 正当理由：每次发送都需要在批准过程中记录和显示理由。
• 铲斗隔离：使用单独的桶来限制代理人对特定资金的访问。
• 令牌权限：API令牌的作用域可以是特定的存储桶。

处理审批流程

当交易超过自动审批限制时，API将返回：

{
  "status": "pending_approval",
  "transaction_id": "...",
  "message": "Awaiting human approval via Telegram",
  "expires_at": "2026-02-04T05:00:00Z"
}

你的代理人应该：

1. 通知用户需要批准
2. 可选投票 wallet_tx_status 检查状态
3. 不要重试同一事务（改用幂等密钥）

发展

# Clone the repository
git clone https://github.com/n8m8/paypls-mcp.git
cd paypls-mcp

# Install dependencies
npm install

# Run in development mode
PAYPLS_TOKEN=pp_your_token npm run dev

# Build
npm run build

# Type check
npm run typecheck

使用的API端点

此MCP服务器与PayPles代理API通信：

API完整文档： paypls.io/SKILL.md

环境变量

测试网

目前正在比特币测试网上运行(tbtc)以及以太坊Sepolia（USDC）。非常适合开发和测试！

API测试网： https://paypls-api-dev.nfwalls.workers.dev 测试网仪表板： test.paypls.io

支持

• 📖 集成指南
• 🐛 问题

许可证

麻省理工学院

______________________________________________________________________

Built with ❤️ for the Circle USDC Hackathon 2026