Log inSubmit server
Xbird logo

Xbird

by checkra1neth

Provides local MCP tools for reading, searching, posting, and managing Twitter/X content through browser cookies.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Xbird

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "checkra1neth-xbird": {
      "command": "bunx",
      "args": [
        "@checkra1n/xbird"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

bunx @checkra1n/xbird

/bin/bash: line 1: bunx: command not found

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

checkra1neth/xbird MCP server exposes Twitter/X capabilities to AI agents through a local MCP process. It provides 247 tools for reading, searching, posting, engagement actions, and media uploads, while using browser cookies instead of an X developer account, API key, or OAuth. MCP requests run locally and use x402 payments for the server-side payment check, with Twitter API calls made from the user's machine. Reach for it when an MCP-compatible client needs to operate an authenticated Twitter/X account.

Use cases

  • Search Twitter/X posts from an AI agent
  • Read timelines, replies, bookmarks, and user data
  • Publish tweets and replies through MCP
  • Manage likes and follows
  • Upload media to Twitter/X

Key features

  • 247 Twitter/X MCP tools
  • Browser-cookie authentication
  • Tweet and reply creation
  • Timeline, search, and user reads
  • Engagement actions and media uploads
  • x402 per-call payments

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @checkra1n/xbird (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars15Stargazers on the source repository.
npm downloads106Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Xbird works

What checkra1neth/xbird MCP server does

checkra1neth/xbird MCP server connects AI agents to Twitter/X through the Model Context Protocol. The repository describes 247 tools covering account and post reading, search, timeline access, publishing, engagement, and media uploads. It is intended for local MCP use with clients such as Claude Code, Claude Desktop, Cursor, and Windsurf.

The MCP skill is one of three distributions in the repository. The other two are a REST API using x402 payments and an ACP integration for Virtuals Protocol. This writeup focuses on the local MCP server package, @checkra1n/xbird.

How it works

The MCP client starts @checkra1n/xbird as a local stdio process. With Bun, the server can automatically find Twitter/X browser cookies.

Twitter/X requests are performed from the user's machine and residential IP. The remote xbird service verifies payments rather than acting as a general credential store or proxy for the Twitter API. A payment wallet is created automatically during the first run, and requests use x402 micropayments. The documented resource rates include separate charges for post reads, user reads, owned-content reads, post creation, interactions, and media uploads.

Setup and configuration

Install the package through Bun or npm. The recommended MCP command is:

bash
bunx @checkra1n/xbird

For Node.js, use:

Terminal
npx @checkra1n/xbird
npx @checkra1n/xbird login

The login command is used to save Twitter/X credentials locally. Bun is described as requiring no manual login when browser cookies are available, while the Node.js path requires the one-time login command.

The repository also documents client-specific installation methods, including Claude Code’s MCP configuration command and direct MCP command configuration for Claude Desktop, Cursor, and Windsurf. No Twitter developer account, API key, or OAuth flow is listed as required for the MCP setup.

Tools and capabilities

The documented tool set supports tasks such as:

  • Reading individual posts, replies, bookmarks, and home timelines
  • Searching Twitter/X content
  • Looking up users and followers
  • Posting tweets and replying to posts
  • Liking posts and following users
  • Uploading media
  • Managing other listed reading and engagement operations across the 247-tool catalog

The pricing examples show count-aware billing for some read operations. For example, searches and reply retrieval can use a requested count, with documented defaults and maximums for applicable resources. Creation and interaction operations are billed as individual resource actions.

Limitations and notes

checkra1neth/xbird MCP server is not described as a free, unlimited Twitter/X connection. Calls incur x402 micropayments, with listed resource rates starting at fractions of a cent per unit. A payment wallet is generated automatically, so an agent deployment must account for payment setup and balance management.

Browser-cookie access differs by runtime: Bun can auto-detect cookies, whereas Node.js requires manually completing the login process. The credentials and payment behavior described here apply to the local MCP path; the repository documents different security and transport models for its REST and ACP distributions.

The project is licensed under MIT. Its compatibility table names Claude Code, Claude Desktop, Cursor, and Windsurf, and also states that any MCP client can use the Bun or npm package command.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Xbird

Run `bunx @checkra1n/xbird` for the recommended Bun setup, or use `npx @checkra1n/xbird` with Node.js. Node.js users must then run the package's `login` command.

Yes. The compatibility table lists Claude Desktop and gives `npx @checkra1n/xbird` as its MCP command.

No. It uses browser cookies instead.

Bun can auto-detect browser cookies. The Node.js setup requires a one-time login using the `auth_token` and `ct0` values copied from x.com browser developer tools.

Yes. The MCP flow uses x402 micropayments, with resource-based rates for reads, posts, interactions, and media uploads.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewXbird AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/checkra1neth-xbird?style=directory)](https://allmcps.com/mcp/checkra1neth-xbird)
HTML Embed
<a href="https://allmcps.com/mcp/checkra1neth-xbird"><img src="https://allmcps.com/api/badge/checkra1neth-xbird?style=directory" alt="Xbird on AllMCPs" /></a>