How do I tweet from Claude Code?

Run one command: 'claude mcp add xbird -- npx @checkra1n/xbird'. xbird auto-detects your Twitter session from Chrome, Firefox, Edge, or Safari — no manual cookie setup needed. A wallet is generated automatically. Then ask Claude to post a tweet.

Do I need a Twitter developer account or API keys?

No. xbird requires no Twitter developer account and no API keys. It auto-detects your browser cookies — the same session your browser uses. No Developer Portal registration, no OAuth app setup, no approval wait. Zero configuration.

What is the best Twitter MCP server?

xbird is the only Twitter MCP server with true zero config — it auto-detects your browser session and generates a wallet automatically. It provides 247 tools across 17 resource types with X API–aligned billing (~2× cheaper per unit). The REST API server is fully stateless — no database, no stored credentials. Hosted /mcp is disabled by default; use local MCP or set XBIRD_ENABLE_REMOTE_MCP=1.

How much does xbird cost?

xbird bills per X API resource unit (~2× cheaper): post_read $0.0025, user_read $0.005, owned_read $0.001, writes $0.0075. List/search tools multiply by count (default 20, max 100). A typical 9-call session with count=20 costs ~$0.13 — about 2× cheaper than the same workflow via X API pay-per-use (~$0.26).

Is xbird a free X API alternative?

The MCP proxy itself is free — you only pay per resource unit starting at $0.001. No subscription, no minimum spend. A typical agent session is ~$0.10–0.15, compared to the X API's $200/month Basic tier.

Which AI agents and editors work with xbird?

xbird works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. It implements the standard Model Context Protocol, so custom MCP implementations work too.

Why use xbird instead of the official X API?

Zero config — install and go. No developer account, no API keys, no OAuth setup. Fully stateless server — no database, no stored credentials. Auto-detects your browser session and generates a wallet. Resource × count billing (~2× cheaper than X API). A 9-call session with count=20 costs ~$0.13 with xbird vs ~$0.26 via X API.

How do I install xbird MCP server?

For Claude Code: run 'claude mcp add xbird -- npx @checkra1n/xbird'. For Cursor or Windsurf: add 'npx @checkra1n/xbird' as an MCP server command. Requires Node.js >= 18 — no Bun needed. xbird auto-detects your Twitter session and generates a wallet — no env vars needed. You can also install globally with 'npm install -g @checkra1n/xbird'.

Can I pay with OKX Agentic Wallet on X Layer?

Yes, opt-in since v0.4.3. Default remains USDC on Base with an auto-generated local wallet. To use OKX Agentic Wallet: install onchainos, log in, then run MCP with XBIRD_PAYMENT_MODE=agentic and XBIRD_PAYMENT_RAIL=xlayer. The API server accepts both Base (USDC) and X Layer (USDT) via x402 dual-rail.

Twitter MCP Server

Tweet from Claude Code

Name: xbird
Author: xbird

No developer account, no API keys — auto-detects your browser session.248 MCP tools + 121 CLI commands, resource × count billing (~2× cheaper than X API). Runs locally, zero config.

claude mcp add xbird -- bunx @checkra1n/xbird

Get Started Agent Skill

xbird / demo

Capabilities

0 Twitter MCP tools — read, write, search, communities, Grok

0 X API–aligned resource types across 14 categories from $0.001/unit (~2× cheaper). List/search tools bill count units (default 20, max 100). No developer account required.

Read toolspost_read $0.0025/unit

get_tweet \u2192 Fetch any tweet by ID

search_tweets \u2192 Full-text search with operators

create_grok_conversation \u2192 Start Grok AI chat

get_community \u2192 Community profile & feed

get_birdwatch_note \u2192 Community Notes (Birdwatch)

+ 72 more in post_read alone

AgentStatus

Claude Code

Supported

Claude Desktop

Supported

Cursor

Supported

Windsurf

Supported

OpenAI Agents

Coming soon

Custom MCP

Supported

Read tweets, threads & timelines — from $0.001/unit

Profiles, trending topics, lists — billed per resource unit. Timelines and search scale with count; single-tweet reads are one unit.

Works with Claude Code, Cursor & Windsurf

Any MCP-compatible agent connects with one command. No developer account, no API keys — just your Twitter cookies.

Write actions48 write & manage tools

✏️Post tweet

$0.0075

↩️Reply

$0.0075

❤️Like / Unlike

$0.0075

🔁Retweet

$0.0075

👤Follow / Unfollow

$0.0075

📷Upload media

$0.005

Searchpost_read × count

search_tweets — Full-text tweet search

get_mentions — Track mentions of any user

Bulk datauser_read × count

user_tweetsfollowersfollowinglikesget_dm_inboxget_exploresearch_communitiesget_audio_space

Post tweets, reply, like & retweet — $0.0075/unit

Follow, bookmark, upload images or video. Your agent can engage exactly like a human would.

Search tweets & track mentions — scales with count

Find tweets by keyword, pull follower lists, and paginate timelines automatically when count > 20. search count=100 → $0.25 (vs $0.50 on X API).

Pricing

Half the X API price — billed per resource unit

Price = resource rate × count (default 20, max 100). List/search tools auto-paginate when count > 20. x402 HTTP 402 amount matches your request — e.g. search count=100 is $0.25. Pay with USDC on Base (default) or USDT on X Layer via OKX Agentic Wallet (opt-in).

Resource catalog

17 types · rate × count

$0.001per unit

$0.0025per unit

$0.005per unit

$0.0075per unit

Default count 20Max 100 units per callAuto-pagination when count > 20

Example agent session

9 calls · count=20 on list/search tools

x402 receipt

search_tweets

×20$0.0500

get_tweet

post read$0.0025

get_tweet

post read$0.0025

get_tweet

post read$0.0025

get_user

user read$0.0050

get_replies

×20$0.0500

post_tweet

post create$0.0075

like_tweet

interaction create$0.0075

upload_media

content create$0.0050

Session total$0.0000

xbird

$0.133

X API (pay-per-use)

$0.265

Same session, ~2× cheaper than X API pay-per-use. Both bill per resource — xbird is ~2× lower unit rates. Large searches still cost less: 100 tweets = $0.25 vs $0.50 on X API.

xbird vs X API

Comparable pay-per-use (xbird ≈ 2× cheaper per unit)

Developer accountNot neededRequired

Pricing modelResource × countPer resource

Search (count=20)$0.05$0.10

Search (count=100)$0.25$0.50

Read a tweet$0.0025$0.005

Post a tweet$0.0075$0.015

Auto-paginationcount > 20Manual cursor

Setup timeZero configHours/days

xbirdX API

FAQ

Tweet from Claude CodeCursorWindsurfyour AI agentClaude Code

0 Twitter MCP tools — read, write, search, communities, Grok

Read tweets, threads & timelines — from $0.001/unit

Works with Claude Code, Cursor & Windsurf