MCP Server

Active

MIT

twitr.sh MCP Server

sh.twitr/twitr

X/Twitter reads, search, monitoring, and posting via AI agents—pay-per-call in USDC, no API keys or signup.

What is the twitr.sh MCP server?

The twitr.sh MCP server provides six installable X/Twitter skills for Claude Code, Cursor, and other agents: live reads, search, real-time monitoring, drafting, publishing, and bulk research exports. Authentication is wallet-based (x402/MPP), with per-call USDC pricing and no developer account or API keys required.

twitr.sh lets your AI agent read tweets, search X, monitor accounts and topics in real-time, draft posts in your voice, publish replies, and export follower/engagement datasets—all without X API credentials. You pay per call in USDC via an agent wallet (AgentCash, awal, pay.sh, or others), with typical weekly costs around $9 for moderate use.

How to install twitr.sh

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

~/.cursor/mcp.json

{
  "mcpServers": {
    "twitr": {
      "url": "https://twitr.sh/api/mcp"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

x-presence — Unattended presence management—watch topics, draft in your voice, publish on schedule, queue replies for approval.
twitter-automation — Automation builder—describe the automation you want and it designs, prices, and wires it from primitives.
x-twitter-data — Live reads—tweets, profiles, search, timelines, lists, communities, trends.
x-twitter-monitor — Real-time monitors delivered by free polling or HMAC-signed webhooks.
x-twitter-publish — Draft with AI, then post, reply, or quote through a connected account.
x-twitter-research — Bulk exports—followers, repliers, reposters—as downloadable datasets.

Use cases

Monitor competitor accounts and get alerted the moment they announce something
Search X for what people are saying about your product and export top results by engagement
Draft multiple tweet variants in your voice and publish the one you choose
Watch multiple topics in real-time and queue replies for your approval before posting
Export all followers or repliers to a tweet as a downloadable dataset for analysis

twitr.sh MCP server FAQ

What is twitr.sh?

twitr.sh is an MCP server that gives AI agents six X/Twitter skills: reading, searching, monitoring, drafting, publishing, and research. No X developer account, API keys, or OAuth required.

How much does it cost?

Pay-per-call in USDC: ~$0.001 to draft, ~$0.0012 per item to read/search, $0.036 to post, ~$0.025/hour to monitor. A typical week of moderate use costs ~$9. Failed calls are never charged.

How do I install it?

Run `npx skills add lnvestor/twitr-skills` (Node 18+ required), or in Claude Code use `/plugin marketplace add lnvestor/twitr-skills`. Then set up a wallet (AgentCash, awal, pay.sh, or others) to pay per call.

Do I need an X/Twitter account?

To post or reply, yes—but you sign in once via a browser link on twitr.sh; your agent never sees your password. Reading, searching, and monitoring work without an account.

Which wallets work?

AgentCash (with up to $25 free onboarding bonus), Coinbase awal, Solana pay.sh, Poncho, and Circle Agent Wallet. Each has its own setup command.

Is it safe to connect my X account?

Yes. Your wallet owns the account; the agent's wallet gets only write access and can be revoked anytime. You sign in yourself in your browser, and the agent never sees your credentials.

README (reference)

Source of truth, from the repository.

X (Twitter) skills for Claude Code — no API key, no developer account

Six installable X/Twitter skills for Claude Code, Cursor, OpenClaw and Hermes — paid per call in USDC. No X developer account, no API keys, no OAuth, no signup, no subscription.

Start in 60 seconds · Ideas · The skills · Wallets · Pricing · Links

</div>

⚡ Start in 60 seconds

Most X/Twitter skills wrap the official API, so the setup is yours: register an X developer account, create an app, complete OAuth, store the tokens, and pay X directly. These skip all of it — your agent's wallet pays per request, and that payment is the authentication.

1 · Install the skills (needs Node 18+ and git on PATH):

npx skills add lnvestor/twitr-skills

Claude Code users can install from the plugin marketplace instead — either path works:

/plugin marketplace add lnvestor/twitr-skills
/plugin install twitr-skills@twitr

2 · Get a wallet. Any x402/MPP wallet works — each one's own documented command:

	Wallet	Try it	Pays on
<img src="https://twitr.sh/wallets/agentcash.svg" width="16" alt="">	AgentCash ⭐	`npx agentcash try https://twitr.sh`	Base · Solana · Tempo
<img src="https://twitr.sh/wallets/awal.png" width="16" alt="">	awal (Coinbase)	`npx awal x402 bazaar search twitr.sh`	Base
<img src="https://twitr.sh/wallets/paysh.png" width="16" alt="">	pay.sh (Solana Foundation)	`pay curl https://twitr.sh`	Solana
<img src="https://twitr.sh/wallets/poncho.svg" width="16" alt="">	Poncho	tryponcho.com/m/twitr.sh	—
<img src="https://twitr.sh/wallets/circle.ico" width="16" alt="">	Circle Agent Wallet	`circle services search "twitr.sh"`	—

First time with agent wallets? → Wallet setup has step-by-step guides (AgentCash's onboarding bonus can even fund you up to $25 for free).

3 · Ask your agent something. The first call returns HTTP 402 with the exact price — that's the quote, not an error. Your wallet pays and retries automatically. $5 covers thousands of reads.

💡 What can my agent do?

Copy-paste any of these once the skills are installed:

"What is @vercel posting about this week?"

"Search X for what people are saying about my product — top 50 by likes, English only."

"Watch @competitor and tell me the moment they announce something." — a real-time monitor; events reach your agent by free polling or signed webhook

"Draft 3 tweet variants announcing our launch in my voice — I'll pick one, then post it."

"Export everyone who replied to this tweet as a dataset."

"Run my X presence: watch these 3 topics, queue drafts every morning, replies wait for my approval."

📦 The skills

Six focused skills with explicit trigger boundaries, so they don't fire over each other.

	Skill	What it does
⭐	`x-presence`	Unattended presence — watch topics, draft in your voice, publish on a schedule, queue replies for approval. Start here — it drives the others internally.
🤖	`twitter-automation`	The automation builder — describe the automation you want (auto-reply, scheduler, watcher, engagement) and it designs, prices, and wires it from the primitives.
🔎	`x-twitter-data`	Live reads — tweets, profiles, search, timelines, lists, communities, trends.
🔔	`x-twitter-monitor`	Real-time monitors, delivered by free polling or HMAC-signed webhooks.
✍️	`x-twitter-publish`	Draft with AI, then post, reply, or quote through a connected account.
📦	`x-twitter-research`	Bulk exports — followers, repliers, reposters — as downloadable datasets.

Install one instead of all six with --skill <name>.

Scheduling x-presence? See scheduling.md — verified commands for Claude Code routines, Hermes cron, and OpenClaw cron.

👛 Wallet setup

<details> <summary><img src="https://twitr.sh/wallets/agentcash.svg" width="14" alt=""> AgentCash — one command, ~2 minutes, and it may pay you up to $25.</summary>

1. Onboard (creates a local wallet, installs the AgentCash skill, and wires up MCP for your agent):

npx agentcash@latest onboard

Visiting agentcash.dev/onboard first and connecting GitHub/X/LinkedIn gets you a claim code worth up to $25 in free USDC — often enough to run these skills for weeks without depositing anything.

2. Fund it (skip if the bonus covered you):

npx agentcash fund

Guided flow with card on-ramp and bridging. No minimum.

3. Check it works — ask your agent "What is my AgentCash balance?" If it answers with a number, you're done.

Claude Code users can alternatively install just the MCP server: claude mcp add agentcash --scope user -- npx -y agentcash@latest

</details> <details> <summary><img src="https://twitr.sh/wallets/awal.png" width="14" alt=""> Coinbase Agentic Wallet (awal) — email OTP login, fund with Apple Pay/card.</summary>

1. Sign in (a 6-digit code lands in your email; verify it):

npx awal@latest auth login
npx awal@latest auth verify <flowId> <otp>

2. Fund it — npx awal@latest show opens the Coinbase Onramp UI (Apple Pay, card, bank).

3. Done. Your agent pays twitr.sh over x402 on Base; to pay an endpoint by hand: npx awal@latest x402 pay <url>.

</details> <details> <summary><img src="https://twitr.sh/wallets/paysh.png" width="14" alt=""> pay.sh — Solana Foundation's payment layer; wraps your agent CLI.</summary>

1. Set up the wallet, then wrap the tool you use:

pay setup
pay claude   # or: pay curl https://twitr.sh/api/tools/x_read ...

pay detects the 402/MPP challenge, asks your local wallet to sign, and retries with payment proof — USDC on Solana. twitr.sh accepts Solana x402 natively.

</details>

Your client's per-call cap is a hard spend limit — no call can exceed it, and failed calls are never charged.

Connecting an X account? Your agent never sees your password — it hands you a single-use link and you sign in on twitr.sh in your own browser. Your wallet owns the account; the agent's wallet only gets write access, and only you can revoke it. See SECURITY.md · full write-up.

💸 What it costs

Action	Price
Reading events from a monitor	free
Drafting a post	~$0.001
A read or search	~$0.0012 / item
A post or reply	$0.036
A monitor	~$0.025 / hour

A typical week running x-presence — two monitors, a dozen replies, a few posts — is about $9. Every 402 quotes the exact price before your wallet signs anything.

🚫 What these skills will not do

The presence and publish skills contain no automated following, unfollowing, or liking, and no keyword-triggered replies.

X prohibits these by name, and its published ranking weights show follows aren't scored at all while a single report scores −369.0 — so the banned tactics cost reach as well as risking the account. twitter-automation exposes the full action set for users who need it, but it prices every design up front, requires explicit confirmation, and warns when a design is spam-shaped enough to risk the account.

Reasoning and sources: ranking-signals.md · x-rules.md

🔗 Links


All six skills	https://twitr.sh/skills
Agent guide	https://twitr.sh/skill.md
Docs	https://twitr.sh/docs
Security model	https://twitr.sh/agent-security
OpenAPI 3.1	https://twitr.sh/openapi.json
MCP	`POST https://twitr.sh/api/mcp`
Payment discovery	x402 · MPP
Explorer listings	x402scan · agentcash

License

MIT — see LICENSE.

Independent service. Not affiliated with X Corp. "X" and "Twitter" are trademarks of X Corp.

Enjoying twitr-skills? A ⭐ on this repo helps other agents find it.

Related MCP servers

uldl

Persistent file storage for AI agents via MCP and curl. Upload, download, and version files.

uploads.sh

Active

Host file artifacts from coding agents and attach them to GitHub PRs with stable public URLs.

TypeScript

Apache-2.0

View repository →

valv

Active

Let coding agents query any SQL database safely. Read-only by default and scoped by your policies.

TypeScript

MIT

View repository →

Watermelon UI

Active

Search and install free React, Tailwind, and shadcn UI components, blocks, and dashboards.

596

TypeScript

MIT

View repository →

Drawbridge

Identity, secrets, and passwordless SSH provisioning for AI agents — Keycloak, vault, MCP tools.

View repository →

Nagora

Active

Buy real goods with Nano (XNO) through escrow. Search, purchase, track orders, get signed receipts.

TypeScript

MIT

View repository →