{
  "data": {
    "tool": {
      "category": "observability",
      "endpoint": "https://twitr.sh/api/mcp",
      "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/twitr.json",
      "kind": "mcp",
      "listed": "indexed",
      "liveUrl": "https://www.anchorterminal.com/api/v1/live/twitr.json",
      "markdownUrl": "https://www.anchorterminal.com/tools/twitr.md",
      "mcpTools": {
        "check": {
          "checker": "anchor-check/1.0",
          "totalTokens": 5676,
          "counts": {
            "error": 0,
            "note": 1,
            "warn": 26
          },
          "findings": [
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_compose",
              "message": "10 parameters without a description: additionalContext, callToAction, draft, goal, hasLink, hasMedia and 4 more",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_draws",
              "message": "11 parameters without a description: backupCount, filterAccountAgeDays, filterLanguage, filterMinFollowers, mustFollowUsername, mustRetweet and 5 more",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_extract",
              "message": "12 parameters without a description: language, mediaType, minFaves, searchQuery, sinceDate, targetCommunityId and 6 more",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_lists",
              "message": "3 parameters without a description: includeReplies, sinceTime, untilTime",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_radar",
              "message": "3 parameters without a description: hours, limit, region",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_search",
              "message": "9 parameters without a description: exactPhrase, excludeWords, fromUser, language, mediaType, minFaves and 3 more",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC11",
              "severity": "warn",
              "tool": "x_timeline",
              "message": "6 parameters without a description: includeParentTweet, includeReplies, language, mediaType, minFaves, verifiedOnly",
              "fix": "Describe each one: format, units, an example, and what happens when it's left out."
            },
            {
              "rule": "TC14",
              "severity": "warn",
              "tool": "x_community",
              "message": "allowed values are in the description, not an enum: community_id",
              "fix": "Move them into enum."
            },
            {
              "rule": "TC14",
              "severity": "warn",
              "tool": "x_write",
              "message": "allowed values are in the description, not an enum: target_tweet_id, target_user_id, text",
              "fix": "Move them into enum."
            },
            {
              "rule": "TC15",
              "severity": "warn",
              "tool": "x_communities",
              "message": "inputSchema has allOf at the top level",
              "fix": "Flatten to one object with optional properties and say in the descriptions which go together."
            },
            {
              "rule": "TC15",
              "severity": "warn",
              "tool": "x_read",
              "message": "inputSchema has allOf at the top level",
              "fix": "Flatten to one object with optional properties and say in the descriptions which go together."
            },
            {
              "rule": "TC15",
              "severity": "warn",
              "tool": "x_search",
              "message": "inputSchema has allOf at the top level",
              "fix": "Flatten to one object with optional properties and say in the descriptions which go together."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_communities",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_community",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_compose",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_draws",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_extract",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_inbox",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_lists",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_monitor",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_profile",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_radar",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_read",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Its name starts with \"read\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_search",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Its name starts with \"search\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_timeline",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC16",
              "severity": "warn",
              "tool": "x_write",
              "message": "no readOnlyHint or destructiveHint",
              "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint."
            },
            {
              "rule": "TC24",
              "severity": "note",
              "message": "14 of 14 tools have no outputSchema",
              "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it."
            }
          ]
        },
        "checkedAt": "2026-10-04T22:25:55Z",
        "count": 14,
        "note": "answered without the initialize handshake",
        "schemaTokens": 5676,
        "status": "ok",
        "tools": [
          {
            "name": "x_read",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "allOf": [
                {
                  "if": {
                    "properties": {
                      "resource": {
                        "const": "followers-you-know"
                      }
                    }
                  },
                  "then": {
                    "required": [
                      "resultsLimit"
                    ]
                  }
                }
              ],
              "properties": {
                "count": {
                  "description": "trends: number of trends to return.",
                  "type": "integer"
                },
                "id": {
                  "description": "Tweet ID, user ID, or username (depends on resource).",
                  "type": "string"
                },
                "ids": {
                  "description": "batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "resource": {
                  "description": "Which read operation to run.",
                  "enum": [
                    "get-tweet",
                    "get-user",
                    "batch-tweets",
                    "batch-users",
                    "check-follower",
                    "trends",
                    "article",
                    "followers-you-know",
                    "download-media"
                  ],
                  "type": "string"
                },
                "resultsLimit": {
                  "description": "Mandatory for followers-you-know: max results, billed per result.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "source": {
                  "description": "check-follower: source username.",
                  "type": "string"
                },
                "target": {
                  "description": "check-follower: target username.",
                  "type": "string"
                },
                "woeid": {
                  "description": "trends: region WOEID (default 1 = worldwide).",
                  "type": "integer"
                }
              },
              "required": [
                "resource"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_search",
            "description": "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.\n\nGuidance: 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).",
            "inputSchema": {
              "allOf": [
                {
                  "else": {
                    "required": [
                      "resultsLimit"
                    ]
                  },
                  "if": {
                    "properties": {
                      "type": {
                        "const": "search-users"
                      }
                    }
                  },
                  "then": {}
                }
              ],
              "properties": {
                "advancedQuery": {
                  "description": "Raw X search operator string appended to q.",
                  "type": "string"
                },
                "cursor": {
                  "description": "search-users: pagination cursor from a previous call's report.next_cursor.",
                  "type": "string"
                },
                "exactPhrase": {
                  "type": "string"
                },
                "excludeWords": {
                  "type": "string"
                },
                "fromUser": {
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "mediaType": {
                  "enum": [
                    "images",
                    "videos",
                    "gifs",
                    "media"
                  ],
                  "type": "string"
                },
                "minFaves": {
                  "type": "integer"
                },
                "minReplies": {
                  "type": "integer"
                },
                "minRetweets": {
                  "type": "integer"
                },
                "q": {
                  "description": "Search query (X operator syntax supported for tweets).",
                  "type": "string"
                },
                "resultsLimit": {
                  "description": "search-tweets: MANDATORY max tweets returned, billed per tweet.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "sinceDate": {
                  "description": "YYYY-MM-DD",
                  "type": "string"
                },
                "type": {
                  "description": "Search tweets (default) or users.",
                  "enum": [
                    "search-tweets",
                    "search-users"
                  ],
                  "type": "string"
                },
                "untilDate": {
                  "description": "YYYY-MM-DD",
                  "type": "string"
                },
                "verifiedOnly": {
                  "type": "boolean"
                }
              },
              "required": [
                "q"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_timeline",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "id": {
                  "description": "User ID/username or tweet ID (depends on kind).",
                  "type": "string"
                },
                "includeParentTweet": {
                  "type": "boolean"
                },
                "includeReplies": {
                  "type": "boolean"
                },
                "kind": {
                  "description": "Which timeline to fetch.",
                  "enum": [
                    "user-tweets",
                    "user-replies",
                    "user-likes",
                    "user-media",
                    "user-mentions",
                    "followers",
                    "following",
                    "verified-followers",
                    "tweet-replies",
                    "tweet-quotes",
                    "tweet-thread",
                    "tweet-favoriters",
                    "tweet-retweeters"
                  ],
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "mediaType": {
                  "enum": [
                    "images",
                    "videos",
                    "gifs",
                    "media"
                  ],
                  "type": "string"
                },
                "minFaves": {
                  "type": "integer"
                },
                "resultsLimit": {
                  "description": "MANDATORY: max items returned, billed per item.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "verifiedOnly": {
                  "type": "boolean"
                }
              },
              "required": [
                "kind",
                "id",
                "resultsLimit"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_lists",
            "description": "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.\n\nGuidance: kind=tweets|members|followers; id = list ID. resultsLimit is MANDATORY — billed per item returned. tweets supports sinceTime/untilTime and includeReplies.",
            "inputSchema": {
              "properties": {
                "id": {
                  "description": "List ID.",
                  "type": "string"
                },
                "includeReplies": {
                  "type": "boolean"
                },
                "kind": {
                  "description": "What to read from the list.",
                  "enum": [
                    "tweets",
                    "members",
                    "followers"
                  ],
                  "type": "string"
                },
                "resultsLimit": {
                  "description": "MANDATORY: max items returned, billed per item.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "sinceTime": {
                  "type": "string"
                },
                "untilTime": {
                  "type": "string"
                }
              },
              "required": [
                "kind",
                "id",
                "resultsLimit"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_communities",
            "description": "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.\n\nGuidance: kind=info (fixed price) or members|moderators|tweets|search (per-item — resultsLimit MANDATORY). id = community ID. search additionally requires q.",
            "inputSchema": {
              "allOf": [
                {
                  "if": {
                    "properties": {
                      "kind": {
                        "const": "search"
                      }
                    }
                  },
                  "then": {
                    "required": [
                      "q"
                    ]
                  }
                }
              ],
              "properties": {
                "id": {
                  "description": "Community ID.",
                  "type": "string"
                },
                "kind": {
                  "description": "What to read.",
                  "enum": [
                    "info",
                    "members",
                    "moderators",
                    "tweets",
                    "search"
                  ],
                  "type": "string"
                },
                "q": {
                  "description": "search: query within the community.",
                  "type": "string"
                },
                "resultsLimit": {
                  "description": "Mandatory for members/moderators/tweets/search: max items, billed per item.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "kind",
                "id"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_extract",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "language": {
                  "type": "string"
                },
                "mediaType": {
                  "enum": [
                    "images",
                    "videos",
                    "gifs",
                    "media"
                  ],
                  "type": "string"
                },
                "minFaves": {
                  "type": "integer"
                },
                "resultsLimit": {
                  "description": "MANDATORY: max results extracted, billed per result.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "searchQuery": {
                  "type": "string"
                },
                "sinceDate": {
                  "type": "string"
                },
                "targetCommunityId": {
                  "type": "string"
                },
                "targetListId": {
                  "type": "string"
                },
                "targetSpaceId": {
                  "type": "string"
                },
                "targetTweetId": {
                  "type": "string"
                },
                "targetUsername": {
                  "type": "string"
                },
                "tool": {
                  "description": "Which extractor to run.",
                  "enum": [
                    "follower_explorer",
                    "following_explorer",
                    "verified_follower_explorer",
                    "post_extractor",
                    "reply_extractor",
                    "repost_extractor",
                    "quote_extractor",
                    "thread_extractor",
                    "article_extractor",
                    "favoriters",
                    "mention_extractor",
                    "user_likes",
                    "user_media",
                    "community_extractor",
                    "community_moderator_explorer",
                    "community_post_extractor",
                    "community_search",
                    "list_member_extractor",
                    "list_post_extractor",
                    "list_follower_explorer",
                    "space_explorer",
                    "people_search",
                    "tweet_search_extractor"
                  ],
                  "type": "string"
                },
                "untilDate": {
                  "type": "string"
                },
                "verifiedOnly": {
                  "type": "boolean"
                }
              },
              "required": [
                "tool",
                "resultsLimit"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_monitor",
            "description": "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.\n\nGuidance: 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).",
            "inputSchema": {
              "properties": {
                "action": {
                  "description": "Create a new monitor or extend an existing one.",
                  "enum": [
                    "create",
                    "extend"
                  ],
                  "type": "string"
                },
                "eventTypes": {
                  "description": "Event types to receive (default: all applicable). Post events (tweet.*) work for any monitor; profile-change events (profile.*.changed) apply to ACCOUNT monitors only.",
                  "items": {
                    "enum": [
                      "tweet.new",
                      "tweet.reply",
                      "tweet.retweet",
                      "tweet.quote",
                      "tweet.media",
                      "tweet.link",
                      "tweet.poll",
                      "tweet.mention",
                      "tweet.hashtag",
                      "tweet.longform",
                      "profile.avatar.changed",
                      "profile.banner.changed",
                      "profile.name.changed",
                      "profile.username.changed",
                      "profile.bio.changed",
                      "profile.location.changed",
                      "profile.url.changed",
                      "profile.verified.changed",
                      "profile.protected.changed",
                      "profile.pinned_tweet.changed",
                      "profile.unavailable.changed"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "hours": {
                  "description": "Prepaid hours to purchase (default 1).",
                  "maximum": 168,
                  "minimum": 1,
                  "type": "integer"
                },
                "monitorId": {
                  "description": "Monitor to extend (extend only).",
                  "type": "string"
                },
                "query": {
                  "description": "X search query to monitor (create, type=keyword).",
                  "maxLength": 512,
                  "type": "string"
                },
                "type": {
                  "description": "Monitor kind (create). Inferred from username/query when omitted.",
                  "enum": [
                    "account",
                    "keyword"
                  ],
                  "type": "string"
                },
                "username": {
                  "description": "X handle to monitor, without @ (create, type=account).",
                  "type": "string"
                }
              },
              "required": [
                "action"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_draws",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "backupCount": {
                  "type": "integer"
                },
                "estimatedEntries": {
                  "description": "Expected replies inspected — drives the fixed price (default 1000).",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "filterAccountAgeDays": {
                  "type": "integer"
                },
                "filterLanguage": {
                  "type": "string"
                },
                "filterMinFollowers": {
                  "type": "integer"
                },
                "mustFollowUsername": {
                  "type": "string"
                },
                "mustRetweet": {
                  "type": "boolean"
                },
                "requiredHashtags": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "requiredKeywords": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "requiredMentions": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "tweetUrl": {
                  "description": "Full tweet URL (https://x.com/user/status/ID).",
                  "type": "string"
                },
                "uniqueAuthorsOnly": {
                  "type": "boolean"
                },
                "winnerCount": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "tweetUrl"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_write",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "account": {
                  "description": "A connected X handle owned by this wallet (no @).",
                  "type": "string"
                },
                "action": {
                  "description": "Which write to perform.",
                  "enum": [
                    "post",
                    "reply",
                    "like",
                    "unlike",
                    "retweet",
                    "unretweet",
                    "follow",
                    "unfollow",
                    "delete_tweet",
                    "send_dm",
                    "remove_follower",
                    "upload_media"
                  ],
                  "type": "string"
                },
                "community_id": {
                  "description": "post: optional community to post into.",
                  "type": "string"
                },
                "is_note_tweet": {
                  "description": "post: long-form note tweet.",
                  "type": "boolean"
                },
                "media_ids": {
                  "description": "send_dm: optional uploaded media ids to attach.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "media_url": {
                  "description": "upload_media: public URL of the file to upload; returns a media_id.",
                  "type": "string"
                },
                "reply_to_tweet_id": {
                  "description": "reply: the tweet being replied to.",
                  "type": "string"
                },
                "target_tweet_id": {
                  "description": "like|unlike|retweet|unretweet|delete_tweet: the target tweet ID.",
                  "type": "string"
                },
                "target_user_id": {
                  "description": "follow|unfollow|send_dm|remove_follower: the numeric X user id of the target (not the @handle). Get it from x_read get-user.",
                  "type": "string"
                },
                "text": {
                  "description": "post|reply|send_dm: the message body.",
                  "type": "string"
                }
              },
              "required": [
                "action",
                "account"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_inbox",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "account": {
                  "description": "A connected X handle owned by this wallet (no @).",
                  "type": "string"
                },
                "action": {
                  "description": "Which inbox read to run.",
                  "enum": [
                    "bookmarks",
                    "bookmark_folders",
                    "notifications",
                    "dm_history"
                  ],
                  "type": "string"
                },
                "folderId": {
                  "description": "bookmarks: optional folder to read.",
                  "type": "string"
                },
                "maxId": {
                  "description": "dm_history: paginate before this message id.",
                  "type": "string"
                },
                "resultsLimit": {
                  "description": "Max items to return (billed per item); ignored for bookmark_folders.",
                  "maximum": 10000,
                  "minimum": 1,
                  "type": "integer"
                },
                "target_user_id": {
                  "description": "dm_history: the other party's user id.",
                  "type": "string"
                },
                "type": {
                  "description": "notifications: optional filter (e.g. mentions).",
                  "type": "string"
                }
              },
              "required": [
                "action",
                "account"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_profile",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "account": {
                  "description": "A connected X handle owned by this wallet (no @).",
                  "type": "string"
                },
                "action": {
                  "description": "Which profile edit to make.",
                  "enum": [
                    "update_profile",
                    "set_avatar",
                    "set_banner"
                  ],
                  "type": "string"
                },
                "description": {
                  "description": "update_profile: new bio.",
                  "type": "string"
                },
                "location": {
                  "description": "update_profile: new location.",
                  "type": "string"
                },
                "media_url": {
                  "description": "set_avatar|set_banner: public image URL.",
                  "type": "string"
                },
                "name": {
                  "description": "update_profile: new display name.",
                  "type": "string"
                },
                "url": {
                  "description": "update_profile: new website URL.",
                  "type": "string"
                }
              },
              "required": [
                "action",
                "account"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_community",
            "description": "Manage X/Twitter Communities as a connected account: create a new community, join or leave an existing one, or delete a community you own.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "account": {
                  "description": "A connected X handle owned by this wallet (no @).",
                  "type": "string"
                },
                "action": {
                  "description": "Which community action.",
                  "enum": [
                    "create",
                    "join",
                    "leave",
                    "delete"
                  ],
                  "type": "string"
                },
                "community_id": {
                  "description": "join|leave|delete: the community ID.",
                  "type": "string"
                },
                "community_name": {
                  "description": "delete: the community name, as confirmation.",
                  "type": "string"
                },
                "description": {
                  "description": "create: optional community description.",
                  "type": "string"
                },
                "name": {
                  "description": "create: the community name.",
                  "type": "string"
                }
              },
              "required": [
                "action",
                "account"
              ],
              "type": "object"
            }
          },
          {
            "name": "x_radar",
            "description": "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.\n\nGuidance: Optional filters: category, region, hours (lookback), limit, source. Use report.next_cursor via `after` for the next page. Flat floor price per call.",
            "inputSchema": {
              "properties": {
                "after": {
                  "description": "Pagination cursor.",
                  "type": "string"
                },
                "category": {
                  "description": "Topic category filter.",
                  "enum": [
                    "general",
                    "tech",
                    "dev",
                    "science",
                    "culture",
                    "politics",
                    "business",
                    "entertainment"
                  ],
                  "type": "string"
                },
                "hours": {
                  "type": "integer"
                },
                "limit": {
                  "type": "integer"
                },
                "region": {
                  "type": "string"
                },
                "source": {
                  "description": "Trend source filter.",
                  "enum": [
                    "github",
                    "google_trends",
                    "hacker_news",
                    "polymarket",
                    "reddit",
                    "trustmrr",
                    "wikipedia"
                  ],
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          {
            "name": "x_compose",
            "description": "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.\n\nGuidance: 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.",
            "inputSchema": {
              "properties": {
                "additionalContext": {
                  "type": "string"
                },
                "callToAction": {
                  "type": "string"
                },
                "draft": {
                  "type": "string"
                },
                "goal": {
                  "type": "string"
                },
                "hasLink": {
                  "type": "boolean"
                },
                "hasMedia": {
                  "type": "boolean"
                },
                "mediaType": {
                  "type": "string"
                },
                "step": {
                  "description": "Composer step.",
                  "enum": [
                    "generate",
                    "refine",
                    "score"
                  ],
                  "type": "string"
                },
                "styleUsername": {
                  "type": "string"
                },
                "tone": {
                  "type": "string"
                },
                "topic": {
                  "type": "string"
                }
              },
              "required": [
                "step"
              ],
              "type": "object"
            }
          }
        ]
      },
      "name": "twitr.sh",
      "note": "Indexed from the official MCP registry: facts and our own checks, not reviewed, so no score, grade or rank.",
      "packages": null,
      "pageJsonUrl": "https://www.anchorterminal.com/tools/twitr.json",
      "popularity": {
        "githubStars": 9
      },
      "registryName": "sh.twitr/twitr",
      "remotes": [
        {
          "type": "streamable-http",
          "url": "https://twitr.sh/api/mcp"
        }
      ],
      "repository": "https://github.com/lnvestor/twitr-skills",
      "reviewed": false,
      "slug": "twitr",
      "source": "the official MCP registry",
      "sourceUrl": "https://registry.modelcontextprotocol.io/v0.1/servers?search=sh.twitr/twitr",
      "summary": "X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.",
      "updatedAt": "2026-07-27T20:02:09Z",
      "url": "https://www.anchorterminal.com/tools/twitr",
      "vendor": "twitr.sh",
      "vendorUrl": "https://twitr.sh",
      "version": "1.0.0",
      "websiteUrl": "https://twitr.sh",
      "where": "hosted",
      "why": [
        "vendor"
      ]
    }
  },
  "kind": "anchor.page",
  "links": {
    "api": "https://www.anchorterminal.com/api/v1/index.json",
    "html": "https://www.anchorterminal.com/tools/twitr",
    "json": "https://www.anchorterminal.com/tools/twitr.json",
    "llms": "https://www.anchorterminal.com/llms.txt",
    "markdown": "https://www.anchorterminal.com/tools/twitr.md",
    "slim": "https://www.anchorterminal.com/tools/twitr.min.md"
  },
  "markdown": "# twitr.sh\n\n\u003e Indexed, not reviewed: facts from the official MCP registry and our own checks. No score, grade or rank, and not in the rankings until the panel reviews it. How the index works: https://www.anchorterminal.com/indexed/\n\n- Kind: MCP server, by twitr.sh (https://twitr.sh)\n- Category: Observability \u0026 incidents (https://www.anchorterminal.com/categories/observability.md)\n- Listed because: It's published in the registry under twitr.sh, a namespace the registry only gives to whoever proves they control that domain.\n- What the official MCP registry says: X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.\n\n## Facts\n\n- MCP registry: `sh.twitr/twitr` 1.0.0\n- Endpoint: https://twitr.sh/api/mcp (streamable HTTP)\n- Source: https://github.com/lnvestor/twitr-skills\n- Website: https://twitr.sh\n- GitHub stars: 9\n- Registry entry updated: 2026-07-27\n\n## Tools\n\n- Tools it lists (14, about 5,676 tokens of context, `tools/list` without credentials, checked 2026-10-04 22:25 UTC):\n  - `x_read`: 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,…\n  - `x_search`: Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only…\n  - `x_timeline`: 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…\n  - `x_lists`: 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…\n  - `x_communities`: 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;…\n  - `x_extract`: Bulk-export X/Twitter data as downloadable datasets: followers, following, repliers, quoters, reposters, likers, mentions, full threads, list and community…\n  - `x_monitor`: 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…\n  - `x_draws`: 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…\n  - `x_write`: 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…\n  - `x_inbox`: Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history. Billed per item returned; readable only…\n  - `x_profile`: 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…\n  - `x_community`: 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:…\n  - `x_radar`: Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with…\n  - `x_compose`: 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,…\n- How its tools read to an agent (0 errors, 26 warnings, 1 note, about 5,676 tokens; rules at https://www.anchorterminal.com/check.md; not part of the score):\n  - warn TC11 x_compose: 10 parameters without a description: additionalContext, callToAction, draft, goal, hasLink, hasMedia and 4 more\n  - warn TC11 x_draws: 11 parameters without a description: backupCount, filterAccountAgeDays, filterLanguage, filterMinFollowers, mustFollowUsername, mustRetweet and 5 more\n  - warn TC11 x_extract: 12 parameters without a description: language, mediaType, minFaves, searchQuery, sinceDate, targetCommunityId and 6 more\n  - warn TC11 x_lists: 3 parameters without a description: includeReplies, sinceTime, untilTime\n  - warn TC11 x_radar: 3 parameters without a description: hours, limit, region\n  - warn TC11 x_search: 9 parameters without a description: exactPhrase, excludeWords, fromUser, language, mediaType, minFaves and 3 more\n  - warn TC11 x_timeline: 6 parameters without a description: includeParentTweet, includeReplies, language, mediaType, minFaves, verifiedOnly\n  - warn TC14 x_community: allowed values are in the description, not an enum: community_id\n  - warn TC14 x_write: allowed values are in the description, not an enum: target_tweet_id, target_user_id, text\n  - warn TC15 x_communities: inputSchema has allOf at the top level\n  - warn TC15 x_read: inputSchema has allOf at the top level\n  - warn TC15 x_search: inputSchema has allOf at the top level\n  - warn TC16 x_communities: no readOnlyHint or destructiveHint\n  - warn TC16 x_community: no readOnlyHint or destructiveHint\n  - warn TC16 x_compose: no readOnlyHint or destructiveHint\n  - warn TC16 x_draws: no readOnlyHint or destructiveHint\n  - warn TC16 x_extract: no readOnlyHint or destructiveHint\n  - warn TC16 x_inbox: no readOnlyHint or destructiveHint\n  - warn TC16 x_lists: no readOnlyHint or destructiveHint\n  - warn TC16 x_monitor: no readOnlyHint or destructiveHint\n  - warn TC16 x_profile: no readOnlyHint or destructiveHint\n  - warn TC16 x_radar: no readOnlyHint or destructiveHint\n  - warn TC16 x_read: no readOnlyHint or destructiveHint\n  - warn TC16 x_search: no readOnlyHint or destructiveHint\n\n- JSON: https://www.anchorterminal.com/api/v1/tools/twitr.json\n- Being indexed says nothing about quality, and nobody can pay for it. Ask for a review: https://www.anchorterminal.com/builders/#claiming\n",
  "meta": {
    "attribution": "Anchor Terminal (https://www.anchorterminal.com)",
    "docs": "https://www.anchorterminal.com/docs/",
    "generatedAt": "2026-10-04",
    "license": "CC-BY-4.0",
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "0.3",
    "openapi": "https://www.anchorterminal.com/openapi.json",
    "preview": false,
    "run": "2026-10-01",
    "runLabel": "October 2026 research run"
  },
  "page": {
    "breadcrumbs": [
      {
        "name": "Home",
        "url": "https://www.anchorterminal.com/"
      },
      {
        "name": "Terminal",
        "url": "https://www.anchorterminal.com/tools/"
      },
      {
        "name": "Indexed",
        "url": "https://www.anchorterminal.com/indexed/"
      },
      {
        "name": "twitr.sh",
        "url": ""
      }
    ],
    "description": "twitr.sh, an MCP server by twitr.sh, listed from the official MCP registry. Indexed, not reviewed: facts and our own checks, no score or ranking. X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.",
    "facts": [
      "not reviewed",
      "not ranked",
      "facts only"
    ],
    "h1": "twitr.sh",
    "image": "https://www.anchorterminal.com/assets/og/indexed.png",
    "path": "/tools/twitr",
    "published": "",
    "section": "indexed",
    "title": "twitr.sh: MCP server, indexed from the official MCP registry",
    "toc": null,
    "updated": "2026-10-04",
    "url": "https://www.anchorterminal.com/tools/twitr"
  },
  "tokens": {
    "markdown": 1650,
    "slim": 1580
  },
  "version": 1
}