# Xbird

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

- **Type:** Skill
- **Install:** `agentstack add skill-checkra1neth-xbird-skill-xbird`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [checkra1neth](https://agentstack.voostack.com/s/checkra1neth)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [checkra1neth](https://github.com/checkra1neth)
- **Source:** https://github.com/checkra1neth/xbird-skill/tree/main/skills/xbird

## Install

```sh
agentstack add skill-checkra1neth-xbird-skill-xbird
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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
```bash
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
```bash
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.

- **Author:** [checkra1neth](https://github.com/checkra1neth)
- **Source:** [checkra1neth/xbird-skill](https://github.com/checkra1neth/xbird-skill)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-checkra1neth-xbird-skill-xbird
- Seller: https://agentstack.voostack.com/s/checkra1neth
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.