From xbird
Enables Twitter/X interactions via 35 MCP Node.js tools: tweet/post threads, search/read tweets/timelines/mentions, manage likes/retweets/bookmarks/followers, update profile/bio/avatar/banner, upload media. Zero-config browser auth.
How this skill is triggered — by the user, by Claude, or both
Slash command
/xbird:xbirdThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
35 MCP tools for Twitter/X with x402 micropayments. Pure Node.js — no Bun required.
35 MCP tools for Twitter/X with x402 micropayments. Pure Node.js — no Bun required.
Zero config — auto-detects your browser session and generates a wallet. No API keys, no developer account.
Don't use when: Building backend services or autonomous agents (use REST x402 instead), or operating on Virtuals marketplace (use ACP instead).
Two runtime options:
claude mcp add xbird -- bunx @checkra1n/xbird
Auto-detects cookies from Chrome, Firefox, Edge, Safari. Just log in to x.com — done.
claude mcp add xbird -- npx @checkra1n/xbird
npx @checkra1n/xbird login # paste auth_token + ct0 from x.com DevTools
A payment wallet is generated automatically on first run.
Full tool list: see tools.md.
Post tweet with image: upload_media (get mediaId) → post_tweet with mediaIds: ["<id>"]
Get someone's tweets: get_user (get numeric userId) → get_user_tweets with userId
Search and engage: search_tweets with query → like_tweet or retweet results
Update profile: update_profile_image + update_profile with new bio
Handles: work with or without @ prefix
Pagination: most tools accept cursor from previous response
Media: always upload first, then attach mediaId to tweet
Pricing: Read $0.001 | Search $0.005 | Bulk/Write $0.01 | Media $0.05
| Mistake | Fix |
|---|---|
| Using handle for bulk tools | get_user_tweets, get_followers, etc. need numeric userId. Call get_user first. |
| Posting thread with 1 tweet | post_thread requires minimum 2 tweets. Use post_tweet for single tweet. |
| Media not attached | Upload returns mediaId — must pass it in mediaIds array to post_tweet. |
| Rate limit error | Twitter rate limit. Wait 1-2 minutes, retry. |
| Cookies not detected | Run npx @checkra1n/xbird login and paste cookies manually. Auto-detect only works with Bun, not npx. |
npx claudepluginhub checkra1neth/xbird-skillX/Twitter API integration for posting tweets and threads, reading timelines, searching, and analytics. Covers OAuth auth patterns and rate limits.
Integrates with X/Twitter API to post tweets and threads, read timelines and user data, search content, and retrieve analytics. Handles OAuth 1.0a/2.0 authentication and rate limits for programmatic use.
Automates Twitter/X tasks like posting, searching users/posts, managing bookmarks/lists/media via Composio's Rube MCP toolkit. Use for social media automation after connecting Twitter OAuth.