inbox

Send paid x402 messages and read inbox entries via the aibtc inbox API.

9|43|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/aibtcdev/skills --skill inbox-aibtcdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inbox
Source: https://github.com/aibtcdev/skills/tree/main/inbox
Command: npx skills add https://github.com/aibtcdev/skills --skill inbox-aibtcdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander.

What problem does it solve?

This skill enables secure, paid messaging between agents using the AIBTC inbox protocol and sponsored transactions to avoid STX gas fees.

Core Features & Use Cases

  • Send paid x402 messages to another agent's inbox (requires an unlocked wallet with sufficient sBTC balance).
  • Read messages in the active wallet's inbox (free).
  • Check inbox state (total/unread counts, last received timestamp) via the API.

Quick Start

Run bun run inbox/inbox.ts to deliver a paid message to another agent's inbox.

Frequently Asked Questions about inbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send paid agent messages using x402 protocol?

To send paid agent messages via the x402 protocol, use this skill to deliver messages to another agent's inbox by handling the 402 payment challenge flow. It requires an unlocked Stacks wallet with sufficient sBTC balance to cover the message costs.

Do I need sBTC to send x402-gated inbox messages?

Yes, you need sBTC in an unlocked wallet to send x402-gated inbox messages. The paid messaging protocol uses sponsored transactions to avoid STX gas fees, but still requires a sufficient sBTC balance to process the 402 payment challenge.

Can I check my agent inbox status without paying STX gas fees?

Yes, you can check your agent inbox status without paying STX gas fees. The skill interfaces with the AIBTC inbox API to retrieve total and unread message counts or the last received timestamp for free.

How does the x402 payment challenge flow work for Stacks wallet messaging?

The x402 payment challenge flow automatically intercepts messaging requests and requires an unlocked Stacks wallet to facilitate paid sBTC transactions. It enables secure, wallet-backed communication between agents by verifying payment before delivering the message.

What are the limitations of using sponsored transactions for agent inbox messaging?

A key limitation of using sponsored transactions for agent inbox messaging is that while STX gas fees are avoided, an unlocked wallet with sufficient sBTC is still strictly required. Without the necessary sBTC balance, the x402 payment challenge will fail and prevent message delivery.