How to connect Claude to Twitter (X) with an MCP server or a skill.

Option 1: how do I install the skills?

Skills teach Claude the whole workflow: which tool to call, how to stay within budget, and how to connect an account safely. A wallet lets it pay. In Claude Code:

# 1) the six twitr skills
npx skills add lnvestor/twitr-skills

# 2) a wallet Claude can pay from (AgentCash, as an MCP server)
claude mcp add agentcash --scope user -- npx -y agentcash@latest

# 3) add USDC, then restart Claude Code so the skills load
npx agentcash fund

Then ask something like “What is @vercel posting about this week?” In Cursor, the skills land in .agents/skills/, and AgentCash goes in .cursor/mcp.json (or run npx agentcash install). Coinbase's awal and pay.sh wallets work too. The docs quickstart has the exact steps for each agent and wallet.

Option 2: how do I add the MCP server?

If you would rather pay by card, sign in at twitr.sh/dashboard with Google, add a balance and create an API key. The key is shown once. Then:

# Claude Code
claude mcp add --transport http twitr https://twitr.sh/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

# Cursor and other MCP clients (mcp.json)
{
  "mcpServers": {
    "twitr": {
      "url": "https://twitr.sh/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Without a key the server still lists its tools for free. Each tool call then answers with a JSON-RPC 402 that a wallet-aware client can pay, so an agent with its own wallet needs no key at all.

Does it work outside Claude Code?

Yes. The skills use the open Agent Skills format, so the same install command works in Cursor, OpenClaw and Hermes. It also works in other skill-aware agents such as Codex, Gemini CLI and Windsurf. For unattended work, OpenClaw's openclaw cron add and Hermes's hermes cron can run the x-presence skill on a schedule, and so can Claude Code routines. If your client speaks MCP but not skills, use option 2: the tools carry their own descriptions and input schemas, so Claude can call them correctly without extra instructions.

Which skill does what?

What can Claude do on X once connected?

The other tools cover profile edits, community management and giveaway draws. Every tool and price is listed on /tools.

How does Claude post without your password?

Posting is the part that needs care, so it doesn't rely on Claude being careful. Claude calls a connect endpoint with only your handle, and that endpoint rejects any request that contains a password or 2FA secret. Claude gets back a link and shows it to you. You open it and sign in to X yourself, on twitr.sh, in your own browser. The link is single-use, tied to the wallet that asked for it, and expires quickly. Once the handle shows as linked, Claude can write as it. You keep the owner role, and only you can disconnect the account. The full design is on agent security.

POST /api/x-accounts/start  {"username":"yourhandle"}   # free; handle only
-> {"connect_url":"https://twitr.sh/connect/<token>"}       # you open this
GET  /api/x-accounts                                        # Claude waits for "linked"
POST /api/tools/x_write  {"action":"post","account":"yourhandle","text":"shipping day"}

How do I keep Claude's spending under control?

An agent that pays for its own calls needs limits you can trust, so they are built into the API rather than left to the prompt:

Fund the wallet with a small amount to start. Most reads cost a fraction of a cent, so a few dollars goes a long way. You can see every call and what it cost in the dashboard after a free sign-in.

What should I ask Claude first?

How does this compare with other X MCP servers?

Price comparisons are on Twitter API vs twitr.sh, twitterapi.io alternative and X API pricing. More skill details are on /skills. Before you connect anything, you can try the free shadowban checker or X algorithm checker on your own account.

FAQ