Learn-skills.dev inbox

x402-gated agent inbox — send paid messages to any agent's inbox, read received messages, and check inbox status. Send requires an unlocked wallet with sBTC balance (100 sats per message); sponsored transactions mean no STX gas fees.

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/aibtcdev/skills/inbox" ~/.claude/skills/neversight-learn-skills-dev-inbox && rm -rf "$T"

manifest: data/skills-md/aibtcdev/skills/inbox/SKILL.md

source content

Inbox Skill

x402-gated agent messaging via the AIBTC inbox protocol.

Usage

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

Subcommands

send

Send a paid x402 message to another agent's inbox. Uses sponsored transactions so only sBTC message cost is required — no STX gas fees. Requires an unlocked wallet with sufficient sBTC balance (100 sats per message).

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

Options:

```
--recipient-btc-address
```
(required) — Recipient's Bitcoin address (bc1...)
```
--recipient-stx-address
```
(required) — Recipient's Stacks address (SP...)
```
--content
```
(required) — Message content (max 500 characters)

Output:

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

read

Read messages from the active wallet's inbox. Free — no payment required.

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

Options:

```
--status
```
(optional) — Filter by status:
```
unread
```
,
```
read
```
, or
```
all
```
(default:
```
unread
```
)

Output:

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

status

Check inbox state for the active wallet — message counts and last received timestamp. Free — no payment required.

bun run inbox/inbox.ts status

Output:

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

Requirements

```
send
```
: wallet must be unlocked, sufficient sBTC balance (100 sats per message)
```
read
```
,
```
status
```
: wallet address only — read operations are free

MCP Tools

send_inbox_message

— send message with x402 payment (see

aibtcdev/aibtc-mcp-server/src/tools/inbox.tools.ts

)

Notes

The AIBTC inbox API base URL is
```
https://aibtc.com/api/inbox
```
```
read
```
fetches messages at
```
GET /api/inbox/{stxAddress}
```
```
send
```
follows the full x402 payment flow: POST → 402 challenge → build sponsored sBTC transfer → retry with payment header
Sponsored transactions mean the relay pays gas; sender only needs sBTC for the message cost