AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Xbird

skill-checkra1neth-xbird-skill-xbird · by checkra1neth

Use when the user asks to tweet, post threads, read tweets, search Twitter/X, check mentions, manage engagement (like/retweet/bookmark), update profile (bio, avatar, banner), upload media, or interact with Twitter accounts. Triggers: twitter, tweet, post, thread, timeline, mentions, followers, following, likes, retweet, bookmark, profile picture, bio.

↗ Repository
— No reviews yet
0 installs
12 views
0.0% view→install

Install

$ agentstack add skill-checkra1neth-xbird-skill-xbird

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Xbird? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

xbird — Twitter/X for AI Agents

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.

When to Use

  • Running inside Claude Code, Cursor, or Windsurf
  • Need direct MCP tool access to Twitter/X
  • Works with Node.js >= 18 — no Bun required

Don't use when: Building backend services or autonomous agents (use REST x402 instead), or operating on Virtuals marketplace (use ACP instead).

Setup

Two runtime options:

Bun (recommended) — zero config

claude mcp add xbird -- bunx @checkra1n/xbird

Auto-detects cookies from Chrome, Firefox, Edge, Safari. Just log in to x.com — done.

Node.js — one-time login

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.

Common Workflows

Post tweet with image: upload_media (get mediaId) → post_tweet with mediaIds: [""]

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

Quick Reference

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

Common Mistakes

| 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. |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Search