# About 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 working 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 one command; credentials are auto-detected from your browser 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 errors.

## Who builds it

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

## Links

- Docs: https://xbird.dev/docs · Markdown: https://xbird.dev/docs.md
- npm: https://www.npmjs.com/package/@checkra1n/xbird
- Contact: https://xbird/contact → https://xbird.dev/contact