Agent skills that give AI agents 35 Twitter/X tools — reading, searching, posting, engagement, media upload — across 3 integration protocols.
No Twitter developer account, no API keys, no OAuth.
| 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 |
Running in Claude Code / Cursor / Windsurf?
→ xbird (MCP)
Building a backend service or autonomous agent?
→ xbird-rest-api (x402 micropayments, USDC on Base)
Operating on Virtuals Protocol marketplace?
→ xbird-acp (E2E encrypted credentials, ECDH + AES-256-GCM)
/plugin install checkra1neth/xbird-skillnpx skills add checkra1neth/xbird-skillBun (recommended) — auto-detects browser cookies:
claude mcp add xbird -- bunx @checkra1n/xbirdNode.js — requires one-time login:
claude mcp add xbird -- npx @checkra1n/xbird
npx @checkra1n/xbird login # paste auth_token + ct0 from x.com DevToolsA 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) |
# Save Twitter credentials locally
npx @checkra1n/xbird loginAI Agent (Claude Code / Cursor / Windsurf)
| MCP stdio
@checkra1n/xbird (local process)
|-- Auto-detect Twitter cookies from browser
|-- Pay x402 --> xbird server (payment only)
'-- Execute --> Twitter API (your residential IP)
The xbird server only verifies payments. All Twitter API calls happen locally from your machine.
Your Backend / Agent
|-- npx @checkra1n/xbird login --> generates stateless token locally
|-- GET /api/search + token --> xbird server
|<-- 402 Payment Required <-- (challenge)
|-- x-payment header (signed) --> (auto via @x402/fetch)
|<-- 200 { data, cursor } <-- (result)
Fully stateless server — no database, no stored credentials. The token is self-contained (xbird_sk_<key>.<ciphertext>.<iv>), decrypted per-request then discarded.
Buyer Agent
|-- ECDH key exchange --> xbird TEE (attestation)
|-- Encrypted credentials + job --> Virtuals relay (claw-api)
|-- Job lifecycle: REQUEST → NEGOTIATION → TRANSACTION → COMPLETED
|<-- Deliverable with results
End-to-end encrypted credentials (ECDH P-256 + AES-256-GCM). The Virtuals relay transports only opaque ciphertext.
| Tier | Price | Examples |
|---|---|---|
| Read | $0.001 | get_tweet, get_user, get_home_timeline |
| Search | $0.005 | search_tweets, get_mentions |
| Bulk/Write | $0.01 | get_user_tweets, post_tweet, like_tweet |
| Media | $0.05 | upload_media |
Example agent session — 9 API calls:
| Call | xbird | X API |
|---|---|---|
search_tweets |
$0.005 | $0.100 |
get_tweet ×3 |
$0.003 | $0.015 |
get_user |
$0.001 | $0.010 |
get_replies |
$0.001 | $0.100 |
post_tweet |
$0.010 | $0.010 |
like_tweet |
$0.010 | $0.015 |
upload_media |
$0.050 | $0.010 |
| Total | $0.080 | $0.260 |
3.2x cheaper. X API charges per resource fetched — a search returning 20 tweets costs 20x the per-tweet price. xbird charges a flat fee per call.
| 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) |
Each skill follows Anthropic's best practices — concise SKILL.md (<500 words) with heavy reference in separate files.
skills/
├── xbird/ # MCP (local tools)
│ ├── SKILL.md # Setup + workflows + common mistakes
│ └── tools.md # 35 MCP tools reference
├── xbird-rest-api/ # REST API + x402 micropayments
│ ├── SKILL.md # Setup + auth + example + common mistakes
│ ├── endpoints.md # Full endpoint tables with pricing
│ └── x402-flow.md # Payment flow + stateless token
└── xbird-acp/ # ACP (Virtuals marketplace)
├── SKILL.md # Setup + example + common mistakes
├── encryption-flow.md # ECDH P-256 + AES-256-GCM details
└── polling.md # Job lifecycle + polling strategies
| 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 |
| 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 |
MIT