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.

Privacy

Privacy policy

Name: xbird
Author: xbird

xbird is built so that we never hold your data in the first place. This page explains exactly what touches what.

Twitter credentials

Your auth_token and ct0 cookies are auto-detected locally from your browser, or supplied by you explicitly.
They are stored only on your machine (local config), encrypted where applicable.
For the hosted REST API, credentials are encrypted client-side (AES-256-GCM with your own key) into a stateless token; the server decrypts per-request, executes, and discards. We operate no credential database.

Request data

The API server is stateless: it keeps no logs of request content, no account registry, and no analytics on tool calls. Payment verification processes only the signed x402 payment header — an amount and wallet signature, not personal data.

Payments

The default wallet is generated locally at ~/.config/xbird/wallet.json and never uploaded. x402 payments settle on-chain (USDC on Base); blockchain transactions are pseudonymous but publicly visible.

Website analytics

This site uses Vercel Analytics — anonymous, aggregated visit metrics without cookies or fingerprinting. No advertising trackers, no cross-site profiling.

Data deletion

We store nothing server-side, so there is nothing to request from us. Deleting your data means deleting local files: remove ~/.config/xbird/ (config, wallet, tokens).

Changes

Material changes to this policy will be published on this page and noted in the repository changelog. Effective date: 2026-08-22.

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