twitr.sh agent skills

X/Twitter for AI agents — paid per call in USDC. No API key, no signup, no subscription.

Install · The skills · Setup · Pricing · Docs

npx skills add lnvestor/twitr-skills

Needs Node 18+ and git on PATH (Termux/minimal containers: install git first).
Works with any skill-aware agent — Claude Code, Cursor, Copilot, OpenClaw, Hermes. Your agent's
wallet pays a fraction of a cent per request over x402 or MPP. The wallet
is the account: there is no key to paste and nothing to sign up for.

The skills

Five focused skills, each 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.
🔎	`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 five with --skill <name>.
Start with x-presence — it drives the others' endpoints internally.

Setup

1. A wallet. Connect AgentCash as an MCP connector, or any
x402-capable client, and fund it with USDC on Base, Solana, or Tempo — first time? open the
quickstart below. Reads cost
$0.0012–0.012 each, so $5 covers thousands of calls — and your client's per-call cap
(AgentCash defaults to $5) is your spend limit; no call can exceed it.

2. There is no step two. No signup, no dashboard, no key. The first call returns HTTP 402
with the exact price — that's the quote, not an error; your client pays and retries
automatically.

First time with agent wallets? One command, ~2 minutes — and it may pay you.

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 — $5 on Base covers thousands of reads.

3. Check it works — ask your agent "What is my AgentCash balance?" If it answers with a number,
you're done: the next twitr.sh call will quote its price in a 402 and your wallet pays automatically.

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

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

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. Failed calls are never charged, and every 402 quotes the exact price before your wallet
signs anything.

What these skills will not do

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. The prohibited actions are omitted from the skills rather than merely discouraged.

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

Discovery


Agent guide	https://twitr.sh/skill.md
Docs	https://twitr.sh/docs
OpenAPI 3.1	https://twitr.sh/openapi.json
MCP	`POST https://twitr.sh/api/mcp`
Payment discovery	x402 · MPP

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.