MCP server

twitr.sh Official

sh.twitr/twitr

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.

Website Source

At a glance

Type

MCP server

Publisher

twitr.sh (verified by the MCP Registry)

Status

Working at last check

Tools

14

Token cost

About 6,475 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http twitr https://twitr.sh/api/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.twitr]
url = "https://twitr.sh/api/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"twitr":{"type":"http","url":"https://twitr.sh/api/mcp"}}}

Antigravity

agy mcp add twitr https://twitr.sh/api/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"twitr","server_url":"https://twitr.sh/api/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"twitr","server_url":"https://twitr.sh/api/mcp"}

Tools

• x_communities ~275 tokens
  Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community. Fixed price for info; billed per item for rosters, tweets, and search. Guidance: kind=info (fixed price) or members|moderators|tweets|search (per-item — resultsLi
• x_community ~311 tokens
  Manage X/Twitter Communities as a connected account: create a new community, join or leave an existing one, or delete a community you own. Guidance: PREREQUISITE: connect an X account. Acts as a handle THIS wallet owns. action=create (name, optional description) | join|leave (community_id) | delete
• x_compose ~280 tokens
  Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options. Flat sub-cent price per step. Guidance: step=generate (topic + goal required; optional tone/styleUsername/addition
• x_draws ~488 tokens
  Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions. Fixed price set upfront from your estimated entry count. Guidance: tweetUrl required. Optional: winnerCount (default 1)
• x_extract ~624 tokens
  Bulk-export X/Twitter data as downloadable datasets: followers, following, repliers, quoters, reposters, likers, mentions, full threads, list and community members, spaces, or people/tweet search results — 23 extractors. Runs async: you get a claim check immediately and poll a free status URL for th
• x_inbox ~417 tokens
  Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history. Billed per item returned; readable only for handles this wallet connected. Guidance: PREREQUISITE: connect an X account (see /api/x-accounts/start). Reads act AS that account, so yo
• x_lists ~242 tokens
  Read an X/Twitter List: its combined tweet timeline, its member roster, or its followers. Billed per item returned. Useful for following a curated set of accounts as one feed. Guidance: kind=tweets|members|followers; id = list ID. resultsLimit is MANDATORY — billed per item returned. tweets support
• x_monitor ~950 tokens
  Watch an X/Twitter account or keyword query in real time: new tweets, replies, quotes, mentions, hashtags, and profile changes, delivered to your agent by free polling or HMAC-signed webhooks. Prepaid by the hour with a hard stop at expiry — no open-ended billing. The way to track a brand, competito
• x_profile ~332 tokens
  Edit a connected X/Twitter account's profile: display name, bio, location, website link, avatar image, and banner image. Acts only on handles this wallet connected. Guidance: PREREQUISITE: connect an X account. Acts as a handle THIS wallet owns. action=update_profile (any of name, description, loca
• x_radar ~280 tokens
  Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with regional and time-window filters. Flat sub-cent price per call; the cheap first stop for what is happening right now. Guidance: Optional filt
• x_read ~525 tokens
  Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls
• x_search ~561 tokens
  Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a top
• x_timeline ~448 tokens
  Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking
• x_write Sends messages · ~742 tokens
  Act on X/Twitter through an account you connect: post a tweet, reply, like, retweet, follow or unfollow, send a DM, delete a tweet, remove a follower, or upload media. Ownership is checked server-side — an agent can only write as a handle its own wallet connected. Guidance: PREREQUISITE: connect an

Browse

• Vercel tools
• Email
• Social media
• Payments
• Cloud and hosting

Related MCP servers

• Synoptic
  Follow live feeds from Twitter/X, Telegram, press releases, SEC filings and more; publish your own.
• Twitter X Aio
  Twitter: Access real-time Twitter/X data as soon as it's posted! With the Twitter/X AIO API, you.
• Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
  Twitter/X, Instagram, Reddit & TikTok data for AI agents. Billions of posts. No API keys.
• ProWebLook
  19 tools for phone, WhatsApp, email, caller ID, IP geo, blacklist, scraping & SERP
• MangroveAI
  Backtest and paper-trade crypto strategies. Free API key or pay per call in USDC (x402).
• Xcatcher — Recent X Posts
  Fetch recent public X/Twitter posts by named handle for monitoring, comparison, OSINT, and research.
• X Twitter
  X (twitter): x, xapi, Twitter, twitter api, twitters ,tweets, tw, twttr, FollowerIds, friendsIds.
• Jojapi Twitter
  X (formerly Twitter): X (formerly Twitter) public and private data API for search, posts (Tweets).

Badge for your README

[![AptLynx](https://aptlynx.net/badge/sh.twitr/twitr.svg)](https://aptlynx.net/servers/sh.twitr/twitr)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents