twitr.sh — Claude Code MCP server: what it does, how to install
Connects your coding agent to X (Twitter) for search, live feeds, monitoring, and publishing. Uses per-call USDC payments instead of API keys.
claude mcp add --transport http twitr https://twitr.sh/api/mcpWhat twitr.sh does
Standard integrations with X force developers through developer portals, app tokens, and recurring bills. The twitr.sh server bypasses developer credentials entirely. Requests target https://twitr.sh/api/mcp while micropayments over x402 handle authentication across Base, Solana, or Tempo.
When your agent calls an endpoint, the service returns an HTTP 402 quote. A compatible agent wallet pays the fee and retries immediately. Available capabilities cover keyword searches, timeline parsing, automated follower exports, and event monitoring via polling or webhooks.
Without an active x402 wallet like AgentCash or Coinbase awal funded with USDC, calls will halt on payment. If you run the companion CLI skills locally, your environment needs Node 18 or higher alongside git.
What it helps with
- Collect recent X posts about a product filtered by highest likes
- Monitor specific competitor profiles for new announcements via webhooks
- Draft promotional post variants and publish the selected copy directly to the feed
- Export repliers and commenters from a specific post into datasets
Example prompts for the agent
- Search X for discussions about our project, filtered to English posts with the highest like count.
- Keep track of @competitor and alert me as soon as they publish a new update.
- Prepare three announcement drafts for our release, wait for my choice, then publish it.
How to install twitr.sh
Platform CLI: remote server
claude mcp add --transport http twitr https://twitr.sh/api/mcpPlatform CLI: remote server
codex mcp add twitrsh --url https://twitr.sh/api/mcpConfig file
{
"mcpServers": {
"twitrsh": {
"url": "https://twitr.sh/api/mcp"
}
}
}Config file
{
"servers": {
"twitrsh": {
"type": "http",
"url": "https://twitr.sh/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http twitrsh https://twitr.sh/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about twitr.sh
How do I install twitr.sh in Claude Code?
Run claude mcp add --transport http twitr https://twitr.sh/api/mcp in your terminal.
What does twitr.sh do?
It gives coding agents live access to X for timeline reads, searches, audience exports, and posting without Twitter developer tokens.
Do I need a Twitter developer account?
No developer account or OAuth application is required. Requests authenticate via pay-per-call USDC micro-transactions.
