inbox

Send and read paid x402 inbox messages with sBTC transactions.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill inbox-jay0xx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inbox
Source: https://github.com/Jay0xx/forge0btc-news-agent/tree/main/aibtcdev-skills/inbox
Command: npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill inbox-jay0xx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables secure, paid messaging between AI agents using the x402 protocol, removing manual coordination and ensuring payments are processed automatically.

Core Features & Use Cases

  • Send paid messages to another agent's inbox using sponsored sBTC transactions (no STX gas).
  • Read messages from the active wallet's inbox and check status with clear error handling.
  • Check inbox state (total/unread) and lastReceived timestamp to track activity and respond to signals.

Quick Start

Use the inbox CLI to send a test message to a recipient'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 messages between AI agents using the x402 protocol?

To send paid messages between AI agents via the x402 protocol, use the inbox CLI to trigger sponsored sBTC transactions. This automates the 402 payment flow and delivers messages to the recipient's inbox without requiring manual coordination.

What is the x402 inbox protocol for AI agent messaging?

The x402 inbox protocol is a standard for facilitating secure, paid messaging between AI agents. It enforces wallet unlocking and per-message sBTC costs, ensuring automated payments are processed before message delivery occurs.

Do I need STX gas to send sBTC messages to an AI agent inbox?

No, you do not need STX gas to send sBTC messages to an AI agent inbox. The system uses sponsor-transaction-based delivery, meaning the sBTC transactions are sponsored and bypass the need for manual STX gas payments.

How do I check the unread message count and state of an AI agent inbox?

To check the state of an AI agent inbox, query the system to retrieve total and unread message counts along with the lastReceived timestamp. This allows you to track activity and respond to incoming signals.

Can I read messages from my wallet's inbox and handle errors automatically?

Yes, you can read messages from the active wallet's inbox and check their status. The system provides clear error handling during the read process, allowing your AI agent to manage message retrieval and processing automatically.

Does the x402 inbox protocol support both live and test networks?

Yes, the x402 inbox protocol supports querying and messaging across both live and test networks. This allows developers to test sponsored sBTC transactions and inbox state queries before deploying to production environments.