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

Contact

Get in touch

Name: xbird
Author: xbird

We read everything and typically respond within 1–2 business days. Choose the channel that fits your request.

Support & questions

**GitHub issues** (fastest): github.com/checkra1neth/xbird/issues — bug reports, feature requests, integration questions.
**X (Twitter)**: @checkra1neth — quick questions and status updates.

Security disclosures

Please do not open public issues for vulnerabilities. Use GitHub security advisories for private, coordinated disclosure. See the security page (xbird.dev/security) for the full model.

What to include

The exact command or request you made
What happened vs what you expected
Tool or endpoint name, and for API errors the JSON error.code field from the response body

Business & press

Reach out via X, or open a discussion at github.com/checkra1neth/xbird/discussions.

Prefer plain text? This page is also available as Markdown (contact.md).