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.

About

xbird — Twitter/X access for AI agents

Name: xbird
Author: xbird

xbird is a Twitter/X integration layer built for AI agents: an MCP server with 248 tools, a stateless REST API, and a CLI — all without a Twitter developer account, API keys, or OAuth app setup.

Why we built it

The official X API prices automation out of reach for most agents ($200/month Basic tier) and gates access behind developer approval. xbird takes a different approach:

**Bring your own account** — you already have a Twitter session in your browser; xbird reuses it locally.
**Pay per call, not per month** — x402 micropayments charge fractions of a cent per request at X API-aligned resource rates (~2× cheaper per unit), settled in USDC on Base (optional X Layer USDT).
**Zero config** — install with one command; credentials are auto-detected and a payment wallet is generated automatically.

Principles

1. **Local-first**: run from your residential IP; your cookies never leave your machine in plaintext. 2. **Stateless**: the hosted REST API stores no credentials — tokens are encrypted client-side and decrypted per-request. 3. **Agent-native**: machine-readable everything — OpenAPI spec, llms.txt, MCP manifest, JSON error envelopes.

Who builds it

xbird is developed by checkra1n (@checkra1neth on X) and is open source under the MIT license at github.com/checkra1neth/xbird.

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