# twitr.sh

Connects your coding agent to X (Twitter) for search, live feeds, monitoring, and publishing. Uses per-call USDC payments instead of API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: lnvestor
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lnvestor/twitr-skills
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/twitrsh

## What it 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`.

## Requirements
- Remote server: `https://twitr.sh/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http twitr https://twitr.sh/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add twitrsh --url https://twitr.sh/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "twitrsh": {
            "url": "https://twitr.sh/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "twitrsh": {
            "type": "http",
            "url": "https://twitr.sh/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http twitrsh https://twitr.sh/api/mcp
```

## When to use it
- 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
- 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.

## Similar
- [agentcash](https://affpapa.org/en/nevibecode/skills/agentcash.md) — skill · 2000 installs
- [x402](https://affpapa.org/en/nevibecode/skills/x402.md) — skill · 1300 installs
- [teneo-cli](https://affpapa.org/en/nevibecode/skills/teneo-cli.md) — skill · 534 installs
- [Agent402.Tools: pay-per-call web tools](https://affpapa.org/en/nevibecode/mcp/agent402tools-pay-per-call-web-tools.md) — MCP server · ★ 47
- [Ausca](https://affpapa.org/en/nevibecode/mcp/ausca.md) — MCP server · ★ 40
- [three.ws Knock](https://affpapa.org/en/nevibecode/mcp/threews-knock.md) — MCP server · ★ 250

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md