Google Search Console integration for Model Context Protocol (MCP)
twitr.sh is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http twitr-sh-mcp https://twitr.sh/api/mcp
# 2 — ask your agent for something these tools do
# x_read, x_search, x_timeline and 11 more
twitr.sh costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http twitr-sh-mcp https://twitr.sh/api/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
14 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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 are never charged. Guidance: resource=get-tweet|get-user (id), batch-tweets|batch-users (ids array
| Parameter | Type | Required | Notes |
|---|---|---|---|
| resource | string | yes | Which read operation to run. |
| id | string | no | Tweet ID, user ID, or username (depends on resource). |
| ids | array | no | batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames. |
| source | string | no | check-follower: source username. |
| target | string | no | check-follower: target username. |
| woeid | integer | no | trends: region WOEID (default 1 = worldwide). |
| count | integer | no | trends: number of trends to return. |
| resultsLimit | integer | no | Mandatory for followers-you-know: max results, billed per result. |
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 topic, brand, or ticker in real time. Guidance: type=search-tweets (default): q required, resultsLimit
| Parameter | Type | Required | Notes |
|---|---|---|---|
| type | string | no | Search tweets (default) or users. |
| q | string | yes | Search query (X operator syntax supported for tweets). |
| resultsLimit | integer | no | search-tweets: MANDATORY max tweets returned, billed per tweet. |
| cursor | string | no | search-users: pagination cursor from a previous call's report.next_cursor. |
| fromUser | string | no | — |
| language | string | no | — |
| sinceDate | string | no | YYYY-MM-DD |
| untilDate | string | no | YYYY-MM-DD |
| mediaType | string | no | — |
| minFaves | integer | no | — |
| minRetweets | integer | no | — |
| minReplies | integer | no | — |
| verifiedOnly | boolean | no | — |
| exactPhrase | string | no | — |
| excludeWords | string | no | — |
| advancedQuery | string | no | Raw X search operator string appended to q. |
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 accounts by activity. Guidance: kind selects the timeline: user-tweets|user-replies|user-likes|user
| Parameter | Type | Required | Notes |
|---|---|---|---|
| kind | string | yes | Which timeline to fetch. |
| id | string | yes | User ID/username or tweet ID (depends on kind). |
| resultsLimit | integer | yes | MANDATORY: max items returned, billed per item. |
| includeReplies | boolean | no | — |
| includeParentTweet | boolean | no | — |
| language | string | no | — |
| mediaType | string | no | — |
| minFaves | integer | no | — |
| verifiedOnly | boolean | no | — |
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 supports sinceTime/untilTime and includeReplies.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| kind | string | yes | What to read from the list. |
| id | string | yes | List ID. |
| resultsLimit | integer | yes | MANDATORY: max items returned, billed per item. |
| sinceTime | string | no | — |
| untilTime | string | no | — |
| includeReplies | boolean | no | — |
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 — resultsLimit MANDATORY). id = community ID. search additionally requires q.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| kind | string | yes | What to read. |
| id | string | yes | Community ID. |
| q | string | no | search: query within the community. |
| resultsLimit | integer | no | Mandatory for members/moderators/tweets/search: max items, billed per item. |
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 the download link. Billed per result. Guidance: tool selects the extractor (23 options). Provide the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tool | string | yes | Which extractor to run. |
| resultsLimit | integer | yes | MANDATORY: max results extracted, billed per result. |
| targetTweetId | string | no | — |
| targetUsername | string | no | — |
| targetCommunityId | string | no | — |
| targetListId | string | no | — |
| targetSpaceId | string | no | — |
| searchQuery | string | no | — |
| language | string | no | — |
| sinceDate | string | no | — |
| untilDate | string | no | — |
| mediaType | string | no | — |
| minFaves | integer | no | — |
| verifiedOnly | boolean | no | — |
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, competitor, or topic without re-polling paid reads. Guidance: action=create needs username (account monitor,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| action | string | yes | Create a new monitor or extend an existing one. |
| type | string | no | Monitor kind (create). Inferred from username/query when omitted. |
| username | string | no | X handle to monitor, without @ (create, type=account). |
| query | string | no | X search query to monitor (create, type=keyword). |
| eventTypes | array | no | Event types to receive (default: all applicable). Post events (tweet.*) work for any monitor; profile-change events (profile.*.changed) apply to ACCOUNT monitors only. |
| hours | integer | no | Prepaid hours to purchase (default 1). |
| monitorId | string | no | Monitor to extend (extend only). |
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), backupCount, uniqueAuthorsOnly, mustRetweet, mustFollowUsername, filterMinFollowers, filterAccount
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tweetUrl | string | yes | Full tweet URL (https://x.com/user/status/ID). |
| winnerCount | integer | no | — |
| backupCount | integer | no | — |
| uniqueAuthorsOnly | boolean | no | — |
| mustRetweet | boolean | no | — |
| mustFollowUsername | string | no | — |
| filterMinFollowers | integer | no | — |
| filterAccountAgeDays | integer | no | — |
| filterLanguage | string | no | — |
| requiredHashtags | array | no | — |
| requiredKeywords | array | no | — |
| requiredMentions | array | no | — |
| estimatedEntries | integer | no | Expected replies inspected — drives the fixed price (default 1000). |
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 X account first — POST /api/x-accounts/start (free, SIWX) with {username} only; it returns a one-ti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| action | string | yes | Which write to perform. |
| account | string | yes | A connected X handle owned by this wallet (no @). |
| text | string | no | post|reply|send_dm: the message body. |
| reply_to_tweet_id | string | no | reply: the tweet being replied to. |
| target_tweet_id | string | no | like|unlike|retweet|unretweet|delete_tweet: the target tweet ID. |
| target_user_id | string | no | follow|unfollow|send_dm|remove_follower: the numeric X user id of the target (not the @handle). Get it from x_read get-user. |
| media_url | string | no | upload_media: public URL of the file to upload; returns a media_id. |
| media_ids | array | no | send_dm: optional uploaded media ids to attach. |
| community_id | string | no | post: optional community to post into. |
| is_note_tweet | boolean | no | post: long-form note tweet. |
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 you can only read the inbox of a handle THIS wallet connected. action=bookmarks (optional folderId) |
| Parameter | Type | Required | Notes |
|---|---|---|---|
| action | string | yes | Which inbox read to run. |
| account | string | yes | A connected X handle owned by this wallet (no @). |
| resultsLimit | integer | no | Max items to return (billed per item); ignored for bookmark_folders. |
| folderId | string | no | bookmarks: optional folder to read. |
| type | string | no | notifications: optional filter (e.g. mentions). |
| target_user_id | string | no | dm_history: the other party's user id. |
| maxId | string | no | dm_history: paginate before this message id. |
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, location, url) | set_avatar (media_url) | set_banner (media_url). account required. Payment settles befo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| action | string | yes | Which profile edit to make. |
| account | string | yes | A connected X handle owned by this wallet (no @). |
| name | string | no | update_profile: new display name. |
| description | string | no | update_profile: new bio. |
| location | string | no | update_profile: new location. |
| url | string | no | update_profile: new website URL. |
| media_url | string | no | set_avatar|set_banner: public image URL. |
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 (community_id + community_name confirmation). account required. Payment settles before the action;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| action | string | yes | Which community action. |
| account | string | yes | A connected X handle owned by this wallet (no @). |
| name | string | no | create: the community name. |
| description | string | no | create: optional community description. |
| community_id | string | no | join|leave|delete: the community ID. |
| community_name | string | no | delete: the community name, as confirmation. |
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 filters: category, region, hours (lookback), limit, source. Use report.next_cursor via after for the n
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | no | Topic category filter. |
| region | string | no | — |
| hours | integer | no | — |
| limit | integer | no | — |
| source | string | no | Trend source filter. |
| after | string | no | Pagination cursor. |
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/additionalContext/callToAction/mediaType/hasLink/hasMedia), refine (draft required), or score (draft require
| Parameter | Type | Required | Notes |
|---|---|---|---|
| step | string | yes | Composer step. |
| topic | string | no | — |
| goal | string | no | — |
| draft | string | no | — |
| tone | string | no | — |
| styleUsername | string | no | — |
| additionalContext | string | no | — |
| callToAction | string | no | — |
| mediaType | string | no | — |
| hasLink | boolean | no | — |
| hasMedia | boolean | no | — |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install twitr.sh or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| x_read | untrusted-inputexternal-sink | untrusted-input: keyword "fetch"; external-sink: keyword "tweet" |
| x_search | external-sink | external-sink: keyword "tweet" |
| x_timeline | untrusted-inputexternal-sink | untrusted-input: keyword "fetch"; external-sink: keyword "tweet" |
| x_lists | external-sink | external-sink: keyword "tweet" |
| x_communities | no tags | |
| x_extract | untrusted-inputexternal-sink | untrusted-input: keyword "download"; external-sink: keyword "tweet" |
| x_monitor | external-sink | external-sink: keyword "webhook" |
| x_draws | no tags | |
| x_write | external-sink | external-sink: keyword "tweet" |
| x_inbox | no tags | |
| x_profile | no tags | |
| x_community | no tags | |
| x_radar | no tags | |
| x_compose | no tags |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.0.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish twitr.sh can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.