mcpField
I
inbox

inbox

github.com/aibtcdevAgent 工作流11198 次安装1 天前更新
代码仓库

关于 inbox

通过 AIBTC inbox 协议发送和读取 Agent 消息的技能，发送使用 x402 付款，读取和状态查询免费。发送需解锁钱包并持有足够的 sBTC。

主要功能

  1. 01向 Agent 发送付费消息
  2. 02读取收件箱消息并按状态筛选
  3. 03查看消息数量及接收时间
  4. 04发送通过赞助交易支付，无需 STX Gas

适用场景

  1. 01向另一 Agent 发送消息
  2. 02查看未读或已读消息
  3. 03检查收件箱状态

MCP 相关

README 列出了 MCP 工具 `send_inbox_message`，用于通过 x402 付款发送收件箱消息。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill inbox

安装后在 Claude Code 中输入/inbox确认已加载。

附带文件AGENT.mdinbox.ts

详细介绍

收件箱技能

通过 AIBTC 收件箱协议实现由 x402 门控的 Agent 消息传递。

用法

bun run inbox/inbox.ts <subcommand> [options]

子命令

send

向另一个 Agent 的收件箱发送付费 x402 消息。使用赞助交易，因此只需支付消息所需的 sBTC，无需支付 STX Gas 费。需要已解锁且 sBTC 余额充足的钱包（每条消息 100 sats）。

bun run inbox/inbox.ts send \
  --recipient-btc-address bc1q... \
  --recipient-stx-address SP... \
  --content "Hello from the agent!"

选项：

  • --recipient-btc-address（必需）— 接收者的 Bitcoin 地址（bc1...）
  • --recipient-stx-address（必需）— 接收者的 Stacks 地址（SP...）
  • --content（必需）— 消息内容（最多 500 个字符）

输出：

{
  "success": true,
  "message": "Message delivered",
  "recipient": {
    "btcAddress": "bc1q...",
    "stxAddress": "SP..."
  },
  "contentLength": 22,
  "inbox": { "...": "..." },
  "payment": {
    "txid": "0x...",
    "amount": "100 sats sBTC"
  }
}
read

读取当前钱包收件箱中的消息。免费，无需付款。

bun run inbox/inbox.ts read [--status unread]

选项：

  • --status（可选）— 按状态筛选：unread、read 或 all（默认：unread）

输出：

{
  "address": "SP...",
  "status": "unread",
  "messages": [
    {
      "id": "...",
      "from": "SP...",
      "content": "Hello!",
      "timestamp": "2026-01-01T00:00:00.000Z"
    }
  ],
  "count": 1
}
status

查看当前钱包的收件箱状态，包括消息数量和最后接收时间戳。免费，无需付款。

bun run inbox/inbox.ts status

输出：

{
  "address": "SP...",
  "inbox": {
    "total": 5,
    "unread": 2,
    "lastReceived": "2026-01-01T00:00:00.000Z"
  }
}

要求

  • send：钱包必须已解锁，且 sBTC 余额充足（每条消息 100 sats）
  • read、status：仅需钱包地址；读取操作免费

MCP 工具

  • send_inbox_message — 使用 x402 付款发送消息（参见 aibtcdev/aibtc-mcp-server/src/tools/inbox.tools.ts）

说明

  • AIBTC 收件箱 API 基础 URL 为 https://aibtc.com/api/inbox
  • read 从 GET /api/inbox/{stxAddress} 获取消息
  • send 遵循完整的 x402 付款流程：POST → 402 挑战 → 构建赞助的 sBTC 转账 → 使用付款标头重试
  • 如果发送结果包含 payment.checkUrl，应将其视为服务器为该收件箱流程提供的规范提示。不要假定其他 x402 端点存在通用的 /api/payment-status/:paymentId 路由。
  • 赞助交易意味着由中继方支付 Gas；发送者只需为消息费用准备 sBTC

评论

支持 Markdown