sh.twitr/twitr

Est-ce que sh.twitr/twitr est sûr ?

Au dernier audit MCP Hub, le serveur MCP « sh.twitr/twitr » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 14 outils

• x_communities≈ 252 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 — resultsLimit MANDATORY). id = community ID. search additionally requires q.

  Paramètres, retour & exemple (4)

  Paramètres

  • q · string · optionnel
    search: query within the community.
  • id · string · requis
    Community ID.
  • kind · string · requis · info | members | moderators | tweets | search
    What to read.
  • resultsLimit · integer · optionnel
    Mandatory for members/moderators/tweets/search: max items, billed per item.

  Exemple d'appel

  {"name": "x_communities", "arguments": {"id": "texte", "kind": "info"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_community≈ 283 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 (community_id + community_name confirmation). account required. Payment settles before the action; Idempotency-Key required.

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · optionnel
    create: the community name.
  • action · string · requis · create | join | leave | delete
    Which community action.
  • account · string · requis
    A connected X handle owned by this wallet (no @).
  • description · string · optionnel
    create: optional community description.
  • community_id · string · optionnel
    join|leave|delete: the community ID.
  • community_name · string · optionnel
    delete: the community name, as confirmation.

  Exemple d'appel

  {"name": "x_community", "arguments": {"action": "create", "account": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_compose≈ 256 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/additionalContext/callToAction/mediaType/hasLink/hasMedia), refine (draft required), or score (draft required). Returns text variants with scores and suggestions. Flat floor price per call.

  Paramètres, retour & exemple (11)

  Paramètres

  • goal · string · optionnel
  • step · string · requis · generate | refine | score
    Composer step.
  • tone · string · optionnel
  • draft · string · optionnel
  • topic · string · optionnel
  • hasLink · boolean · optionnel
  • hasMedia · boolean · optionnel
  • mediaType · string · optionnel
  • callToAction · string · optionnel
  • styleUsername · string · optionnel
  • additionalContext · string · optionnel

  Exemple d'appel

  {"name": "x_compose", "arguments": {"step": "generate"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_draws≈ 444 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), backupCount, uniqueAuthorsOnly, mustRetweet, mustFollowUsername, filterMinFollowers, filterAccountAgeDays, filterLanguage, requiredHashtags/Keywords/Mentions. Pricing is fixed upfront from the estimatedEntries you set (default 1000, max 10000) — set it near the tweet's reply count; that number is enforced as a hard cap. Payment settles before the draw runs, so pay only when you intend to run it; a failed draw does not auto-refund (contact support). Idempotency-Key header required — retries with the same key replay the original result instead of re-charging.

  Paramètres, retour & exemple (13)

  Paramètres

  • tweetUrl · string · requis
    Full tweet URL (https://x.com/user/status/ID).
  • backupCount · integer · optionnel
  • mustRetweet · boolean · optionnel
  • winnerCount · integer · optionnel
  • filterLanguage · string · optionnel
  • estimatedEntries · integer · optionnel
    Expected replies inspected — drives the fixed price (default 1000).
  • requiredHashtags · array · optionnel
  • requiredKeywords · array · optionnel
  • requiredMentions · array · optionnel
  • uniqueAuthorsOnly · boolean · optionnel
  • filterMinFollowers · integer · optionnel
  • mustFollowUsername · string · optionnel
  • filterAccountAgeDays · integer · optionnel

  Exemple d'appel

  {"name": "x_draws", "arguments": {"tweetUrl": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_extract≈ 568 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 the download link. Billed per result. Guidance: tool selects the extractor (23 options). Provide the matching target: targetTweetId (reply/repost/quote/thread/article/favoriters extractors), targetUsername (follower/following/verified/post/mention/likes/media), targetCommunityId, targetListId, targetSpaceId, or searchQuery (people_search, tweet_search_extractor). resultsLimit is MANDATORY — billed per result (article_extractor bills 5× per result). Runs ASYNC: the response is a claim check {snapshot_id, status_url}; poll status_url (free, SIWX) until status=ready for the download link. Idempotency-Key header is required so retries reuse the same job.

  Paramètres, retour & exemple (14)

  Paramètres

  • tool · string · requis · follower_explorer | following_explorer | verified_follower_explorer | post_extractor | reply_extractor | repost_extractor | quote_extractor | thread_extractor
    Which extractor to run.
  • language · string · optionnel
  • minFaves · integer · optionnel
  • mediaType · string · optionnel · images | videos | gifs | media
  • sinceDate · string · optionnel
  • untilDate · string · optionnel
  • searchQuery · string · optionnel
  • resultsLimit · integer · requis
    MANDATORY: max results extracted, billed per result.
  • targetListId · string · optionnel
  • verifiedOnly · boolean · optionnel
  • targetSpaceId · string · optionnel
  • targetTweetId · string · optionnel
  • targetUsername · string · optionnel
  • targetCommunityId · string · optionnel

  Exemple d'appel

  {"name": "x_extract", "arguments": {"tool": "follower_explorer", "resultsLimit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_inbox≈ 378 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 you can only read the inbox of a handle THIS wallet connected. action=bookmarks (optional folderId) | bookmark_folders | notifications (optional type) | dm_history (target_user_id required). bookmarks/notifications/dm_history are billed per item — set resultsLimit (1–10000). account (the connected handle) is required.

  Paramètres, retour & exemple (7)

  Paramètres

  • type · string · optionnel
    notifications: optional filter (e.g. mentions).
  • maxId · string · optionnel
    dm_history: paginate before this message id.
  • action · string · requis · bookmarks | bookmark_folders | notifications | dm_history
    Which inbox read to run.
  • account · string · requis
    A connected X handle owned by this wallet (no @).
  • folderId · string · optionnel
    bookmarks: optional folder to read.
  • resultsLimit · integer · optionnel
    Max items to return (billed per item); ignored for bookmark_folders.
  • target_user_id · string · optionnel
    dm_history: the other party's user id.

  Exemple d'appel

  {"name": "x_inbox", "arguments": {"action": "bookmarks", "account": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_lists≈ 222 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 supports sinceTime/untilTime and includeReplies.

  Paramètres, retour & exemple (6)

  Paramètres

  • id · string · requis
    List ID.
  • kind · string · requis · tweets | members | followers
    What to read from the list.
  • sinceTime · string · optionnel
  • untilTime · string · optionnel
  • resultsLimit · integer · requis
    MANDATORY: max items returned, billed per item.
  • includeReplies · boolean · optionnel

  Exemple d'appel

  {"name": "x_lists", "arguments": {"id": "texte", "kind": "tweets", "resultsLimit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_monitor≈ 851 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, competitor, or topic without re-polling paid reads. Guidance: action=create needs username (account monitor, e.g. "vercel") OR query (keyword monitor, X search syntax, ≤512 chars), optional eventTypes — 21 available: post events (tweet.new, .reply, .retweet, .quote, .media, .link, .poll, .mention, .hashtag, .longform) for any monitor, plus profile-change events (profile.avatar/banner/name/username/bio/location/url/verified/protected/pinned_tweet/unavailable.changed) for ACCOUNT monitors only; default all applicable — and hours (1–168, default 1). action=extend needs monitorId + hours; hours append to the current expiry (total prepaid window ≤ 720h). Extend at least 5 minutes BEFORE expiry — extends inside the final 5 minutes are refused (unpaid) to keep settlement from racing the expiry teardown. PREPAID: the monitor stops and is removed at expires_at unless extended — no open-ended billing; early deletion does not refund remaining hours. Idempotency-Key header REQUIRED — retries replay the original monitor instead of re-charging (on the MCP door, retries are protected by single-use payment credentials instead). Pay with USDC on Base (x402) or Tempo (MPP); Solana is not offered for monitors (stateful resources need a recoverable owner wallet). After creation: poll events at /api/monitors/{id}/events (free — SIWX sign-in with the paying wallet; do NOT poll in a tight loop) or register an HTTPS webhook once at /api/webhooks to push signed events straight to your AI agent (Claude, OpenClaw, Hermes, or any endpoint) in real time. Manage monitors at /api/monitors (SIWX).

  Paramètres, retour & exemple (7)

  Paramètres

  • type · string · optionnel · account | keyword
    Monitor kind (create). Inferred from username/query when omitted.
  • hours · integer · optionnel
    Prepaid hours to purchase (default 1).
  • query · string · optionnel
    X search query to monitor (create, type=keyword).
  • action · string · requis · create | extend
    Create a new monitor or extend an existing one.
  • username · string · optionnel
    X handle to monitor, without @ (create, type=account).
  • monitorId · string · optionnel
    Monitor to extend (extend only).
  • eventTypes · array · optionnel
    Event types to receive (default: all applicable). Post events (tweet.*) work for any monitor; profile-change events (profile.*.changed) apply to ACCOUNT monitors only.

  Exemple d'appel

  {"name": "x_monitor", "arguments": {"action": "create"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_profile≈ 302 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, location, url) | set_avatar (media_url) | set_banner (media_url). account required. Payment settles before the change; Idempotency-Key required.

  Paramètres, retour & exemple (7)

  Paramètres

  • url · string · optionnel
    update_profile: new website URL.
  • name · string · optionnel
    update_profile: new display name.
  • action · string · requis · update_profile | set_avatar | set_banner
    Which profile edit to make.
  • account · string · requis
    A connected X handle owned by this wallet (no @).
  • location · string · optionnel
    update_profile: new location.
  • media_url · string · optionnel
    set_avatar|set_banner: public image URL.
  • description · string · optionnel
    update_profile: new bio.

  Exemple d'appel

  {"name": "x_profile", "arguments": {"action": "update_profile", "account": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_radar≈ 256 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 filters: category, region, hours (lookback), limit, source. Use report.next_cursor via `after` for the next page. Flat floor price per call.

  Paramètres, retour & exemple (6)

  Paramètres

  • after · string · optionnel
    Pagination cursor.
  • hours · integer · optionnel
  • limit · integer · optionnel
  • region · string · optionnel
  • source · string · optionnel · github | google_trends | hacker_news | polymarket | reddit | trustmrr | wikipedia
    Trend source filter.
  • category · string · optionnel · general | tech | dev | science | culture | politics | business | entertainment
    Topic category filter.

  Exemple d'appel

  {"name": "x_radar", "arguments": {"after": "texte", "hours": 1, "limit": 1, "region": "texte", "source": "github", "category": "general"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_read≈ 477 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 are never charged. Guidance: resource=get-tweet|get-user (id), batch-tweets|batch-users (ids array, ≤100), check-follower (source+target usernames), trends (optional woeid/count), article (tweet id), followers-you-know (id + mandatory resultsLimit), download-media (id or ids ≤50 — returns media file URLs on THIS origin; links live 7 days). Fixed-price per call/id except followers-you-know which is per-result.

  Paramètres, retour & exemple (8)

  Paramètres

  • id · string · optionnel
    Tweet ID, user ID, or username (depends on resource).
  • ids · array · optionnel
    batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames.
  • count · integer · optionnel
    trends: number of trends to return.
  • woeid · integer · optionnel
    trends: region WOEID (default 1 = worldwide).
  • source · string · optionnel
    check-follower: source username.
  • target · string · optionnel
    check-follower: target username.
  • resource · string · requis · get-tweet | get-user | batch-tweets | batch-users | check-follower | trends | article | followers-you-know
    Which read operation to run.
  • resultsLimit · integer · optionnel
    Mandatory for followers-you-know: max results, billed per result.

  Exemple d'appel

  {"name": "x_read", "arguments": {"resource": "get-tweet"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_search≈ 514 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 topic, brand, or ticker in real time. Guidance: type=search-tweets (default): q required, resultsLimit MANDATORY (billed per tweet returned). Supports the full filter set: fromUser, language, sinceDate/untilDate, mediaType, minFaves, verifiedOnly, exactPhrase, excludeWords, advancedQuery, and more. type=search-users: q required; returns one results page per call — follow report.next_cursor for the next page (each page is a separate paid call).

  Paramètres, retour & exemple (16)

  Paramètres

  • q · string · requis
    Search query (X operator syntax supported for tweets).
  • type · string · optionnel · search-tweets | search-users
    Search tweets (default) or users.
  • cursor · string · optionnel
    search-users: pagination cursor from a previous call's report.next_cursor.
  • fromUser · string · optionnel
  • language · string · optionnel
  • minFaves · integer · optionnel
  • mediaType · string · optionnel · images | videos | gifs | media
  • sinceDate · string · optionnel
    YYYY-MM-DD
  • untilDate · string · optionnel
    YYYY-MM-DD
  • minReplies · integer · optionnel
  • exactPhrase · string · optionnel
  • minRetweets · integer · optionnel
  • excludeWords · string · optionnel
  • resultsLimit · integer · optionnel
    search-tweets: MANDATORY max tweets returned, billed per tweet.
  • verifiedOnly · boolean · optionnel
  • advancedQuery · string · optionnel
    Raw X search operator string appended to q.

  Exemple d'appel

  {"name": "x_search", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_timeline≈ 408 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 accounts by activity. Guidance: kind selects the timeline: user-tweets|user-replies|user-likes|user-media|user-mentions|followers|following|verified-followers (id = user) or tweet-replies|tweet-quotes|tweet-thread|tweet-favoriters|tweet-retweeters (id = tweet). resultsLimit is MANDATORY — billed per item returned. Search-operator filters (fromUser, language, mediaType, minFaves, …) apply to tweet timelines.

  Paramètres, retour & exemple (9)

  Paramètres

  • id · string · requis
    User ID/username or tweet ID (depends on kind).
  • kind · string · requis · user-tweets | user-replies | user-likes | user-media | user-mentions | followers | following | verified-followers
    Which timeline to fetch.
  • language · string · optionnel
  • minFaves · integer · optionnel
  • mediaType · string · optionnel · images | videos | gifs | media
  • resultsLimit · integer · requis
    MANDATORY: max items returned, billed per item.
  • verifiedOnly · boolean · optionnel
  • includeReplies · boolean · optionnel
  • includeParentTweet · boolean · optionnel

  Exemple d'appel

  {"name": "x_timeline", "arguments": {"id": "texte", "kind": "user-tweets", "resultsLimit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• x_write≈ 668 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 X account first — POST /api/x-accounts/start (free, SIWX) with {username} only; it returns a one-time connect_url the USER opens in their own browser to sign in there. Never ask the user for their X password, email, or 2FA secret. Poll GET /api/x-accounts until the handle shows linked, then reference it in `account`. Actions: post (text) | reply (text + reply_to_tweet_id) | like|unlike|retweet|unretweet|delete_tweet (target_tweet_id) | follow|unfollow (target_user_id — the NUMERIC user id, get it from x_read get-user) | remove_follower (target_user_id of the follower) | send_dm (target_user_id + text) | upload_media (media_url → returns media_id). You can only write as a handle THIS wallet connected (checked server-side; the input account is not trusted). Payment settles before the action runs and is non-refundable; a write may return status=pending_confirmation with an actionId to poll — do NOT resend. Idempotency-Key header is required so a retry replays the original result instead of acting twice.

  Paramètres, retour & exemple (10)

  Paramètres

  • text · string · optionnel
    post|reply|send_dm: the message body.
  • action · string · requis · post | reply | like | unlike | retweet | unretweet | follow | unfollow
    Which write to perform.
  • account · string · requis
    A connected X handle owned by this wallet (no @).
  • media_ids · array · optionnel
    send_dm: optional uploaded media ids to attach.
  • media_url · string · optionnel
    upload_media: public URL of the file to upload; returns a media_id.
  • community_id · string · optionnel
    post: optional community to post into.
  • is_note_tweet · boolean · optionnel
    post: long-form note tweet.
  • target_user_id · string · optionnel
    follow|unfollow|send_dm|remove_follower: the numeric X user id of the target (not the @handle). Get it from x_read get-user.
  • target_tweet_id · string · optionnel
    like|unlike|retweet|unretweet|delete_tweet: the target tweet ID.
  • reply_to_tweet_id · string · optionnel
    reply: the tweet being replied to.

  Exemple d'appel

  {"name": "x_write", "arguments": {"action": "post", "account": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://twitr.sh/api/mcp