Xbird README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Xbird listing page.
xbird — Twitter/X for AI Agents
Agent skills that give AI agents 247 Twitter/X tools — reading, searching, posting, engagement, media upload — across 3 integration protocols.
No Twitter developer account, no API keys, no OAuth.
Skills
| Skill | Protocol | Best For |
|---|---|---|
| xbird | MCP (stdio) | Claude Code, Cursor, Windsurf — local MCP tools |
| xbird-rest-api | REST + x402 | Backend services, autonomous agents, any HTTP client |
| xbird-acp | ACP (Virtuals) | Agent-to-agent commerce on Virtuals Protocol marketplace |
Which skill to use?
Quick Install
Claude Code Plugin
Agent Skill (works with 35+ agents)
MCP Server Only
Bun (recommended) — auto-detects browser cookies:
Node.js — requires one-time login:
A payment wallet is generated automatically on first run.
Bun (bunx) | Node.js (npx) | |
|---|---|---|
| Browser cookies | Auto-detected | Manual login required |
| Setup | Install Bun, done | One-time login command |
| Startup | Faster | Slower (npm registry check) |
CLI
How It Works
MCP (Local)
The xbird server only verifies payments. All Twitter API calls happen locally from your machine.
REST API (Stateless)
Fully stateless server — no database, no stored credentials. The token is self-contained (xbird_sk_<key>.<ciphertext>.<iv>), decrypted per-request then discarded.
ACP (Virtuals Protocol)
End-to-end encrypted credentials (ECDH P-256 + AES-256-GCM). The Virtuals relay transports only opaque ciphertext.
Pricing
Resource catalog billing (~2× cheaper than X API pay-per-use per unit):
| Resource | Rate/unit | Count-aware | Examples |
|---|---|---|---|
post_read | $0.0025 | yes (default 20, max 100) | get_tweet, search_tweets, get_replies |
user_read | $0.005 | yes | get_user, get_followers |
owned_read | $0.001 | yes | get_bookmarks, get_home_timeline |
post_create | $0.0075 | no | post_tweet, reply_to_tweet |
interaction_create | $0.0075 | no | like_tweet, follow_user |
content_create | $0.005 | no | upload_media |
Comparison with X API
Example session (9 calls, count=20 on search/lists):
| Call | xbird | X API |
|---|---|---|
search_tweets count=20 | $0.05 | $0.10 |
get_tweet ×3 | $0.0075 | $0.015 |
get_user | $0.005 | $0.010 |
get_replies count=20 | $0.05 | $0.10 |
post_tweet | $0.0075 | $0.015 |
like_tweet | $0.0075 | $0.015 |
upload_media | $0.005 | $0.015 |
| Total | ~$0.13 | ~$0.26 |
Both bill per resource unit — xbird unit rates are ~2× lower.
Security
| Protocol | Credential Protection |
|---|---|
| MCP | Auto-detected from browser, never leave your machine |
| REST x402 | Fully stateless — encrypted in self-contained token, server stores nothing |
| ACP | ECDH P-256 + AES-256-GCM end-to-end encryption (relay-blind) |
Skill Structure
Each skill follows Anthropic's best practices — concise SKILL.md (<500 words) with heavy reference in separate files.
Compatibility
| Client | Install Method |
|---|---|
| Claude Code | /plugin install checkra1neth/xbird-skill |
| Claude Desktop | npx @checkra1n/xbird as MCP command |
| Cursor | npx @checkra1n/xbird as MCP command |
| Windsurf | npx @checkra1n/xbird as MCP command |
| Smithery | npx -y @smithery/cli install @checkra1neth/xbirdmcp |
| Any MCP client | bunx @checkra1n/xbird / npx @checkra1n/xbird |
Distribution
| Platform | Install |
|---|---|
| npm | @checkra1n/xbird |
| Claude Code Plugin | /plugin install checkra1neth/xbird-skill |
| skills.sh | npx skills add checkra1neth/xbird-skill |
| Smithery MCP | @checkra1neth/xbirdmcp |
| Smithery Skill | checkra1neth/xbird |
| SkillsMP | skillsmp.com |
| Website | xbird.dev |
License
MIT