{"apiVersion":"v1","directorySlug":"twitr-mcp-e0adb4b1bd","title":"twitr.sh — pay-per-call X/Twitter API for AI agents","description":"The X/Twitter API and agent skill for AI agents. One command in Claude Code, Cursor or OpenClaw — read, search, monitor and post, paid in USDC. No API key.","pageUrl":"https://www.mcpbundles.com/skills/twitr-mcp-e0adb4b1bd","connectPath":"importable","connectAction":"import_server","catalogListing":false,"bundleSlug":null,"listingKind":"remote_mcp","kind":"provider","transportUrl":"https://twitr.sh/api/mcp","hostedMcpUrl":null,"toolCount":14,"toolInventoryStatus":"observed","refreshedAt":"2026-11-16T11:41:43.887283+00:00","registryName":"sh.twitr/twitr-mcp-e0adb4b1bd","registryVersion":"2026.11.16","registryEligible":true,"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.","inputSchema":{"type":"object","allOf":[{"if":{"properties":{"resource":{"const":"followers-you-know"}}},"then":{"required":["resultsLimit"]}}],"required":["resource"],"properties":{"id":{"type":"string"},"ids":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"woeid":{"type":"integer"},"source":{"type":"string"},"target":{"type":"string"},"resource":{"enum":["get-tweet","get-user","batch-tweets","batch-users","check-follower","trends","article","followers-you-know","download-media"],"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1}}},"logicalName":"x_read","displayName":"x_read","title":"x_read","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","allOf":[{"if":{"properties":{"type":{"const":"search-users"}}},"else":{"required":["resultsLimit"]},"then":{}}],"required":["q"],"properties":{"q":{"type":"string"},"type":{"enum":["search-tweets","search-users"],"type":"string"},"cursor":{"type":"string"},"fromUser":{"type":"string"},"language":{"type":"string"},"minFaves":{"type":"integer"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"sinceDate":{"type":"string"},"untilDate":{"type":"string"},"minReplies":{"type":"integer"},"exactPhrase":{"type":"string"},"minRetweets":{"type":"integer"},"excludeWords":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1},"verifiedOnly":{"type":"boolean"},"advancedQuery":{"type":"string"}}},"logicalName":"x_search","displayName":"x_search","title":"x_search","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["kind","id","resultsLimit"],"properties":{"id":{"type":"string"},"kind":{"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"},"minFaves":{"type":"integer"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1},"verifiedOnly":{"type":"boolean"},"includeReplies":{"type":"boolean"},"includeParentTweet":{"type":"boolean"}}},"logicalName":"x_timeline","displayName":"x_timeline","title":"x_timeline","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["kind","id","resultsLimit"],"properties":{"id":{"type":"string"},"kind":{"enum":["tweets","members","followers"],"type":"string"},"sinceTime":{"type":"string"},"untilTime":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1},"includeReplies":{"type":"boolean"}}},"logicalName":"x_lists","displayName":"x_lists","title":"x_lists","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","allOf":[{"if":{"properties":{"kind":{"const":"search"}}},"then":{"required":["q"]}}],"required":["kind","id"],"properties":{"q":{"type":"string"},"id":{"type":"string"},"kind":{"enum":["info","members","moderators","tweets","search"],"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1}}},"logicalName":"x_communities","displayName":"x_communities","title":"x_communities","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["tool","resultsLimit"],"properties":{"tool":{"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"},"language":{"type":"string"},"minFaves":{"type":"integer"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"sinceDate":{"type":"string"},"untilDate":{"type":"string"},"searchQuery":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1},"targetListId":{"type":"string"},"verifiedOnly":{"type":"boolean"},"targetSpaceId":{"type":"string"},"targetTweetId":{"type":"string"},"targetUsername":{"type":"string"},"targetCommunityId":{"type":"string"}}},"logicalName":"x_extract","displayName":"x_extract","title":"x_extract","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["action"],"properties":{"type":{"enum":["account","keyword"],"type":"string"},"hours":{"type":"integer","maximum":168,"minimum":1},"query":{"type":"string","maxLength":512},"action":{"enum":["create","extend"],"type":"string"},"username":{"type":"string"},"monitorId":{"type":"string"},"eventTypes":{"type":"array","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"}}}},"logicalName":"x_monitor","displayName":"x_monitor","title":"x_monitor","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["tweetUrl"],"properties":{"tweetUrl":{"type":"string"},"backupCount":{"type":"integer"},"mustRetweet":{"type":"boolean"},"winnerCount":{"type":"integer","minimum":1},"filterLanguage":{"type":"string"},"estimatedEntries":{"type":"integer","maximum":10000,"minimum":1},"requiredHashtags":{"type":"array","items":{"type":"string"}},"requiredKeywords":{"type":"array","items":{"type":"string"}},"requiredMentions":{"type":"array","items":{"type":"string"}},"uniqueAuthorsOnly":{"type":"boolean"},"filterMinFollowers":{"type":"integer"},"mustFollowUsername":{"type":"string"},"filterAccountAgeDays":{"type":"integer"}}},"logicalName":"x_draws","displayName":"x_draws","title":"x_draws","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["action","account"],"properties":{"text":{"type":"string"},"action":{"enum":["post","reply","like","unlike","retweet","unretweet","follow","unfollow","delete_tweet","send_dm","remove_follower","upload_media"],"type":"string"},"account":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}},"media_url":{"type":"string"},"community_id":{"type":"string"},"is_note_tweet":{"type":"boolean"},"target_user_id":{"type":"string"},"target_tweet_id":{"type":"string"},"reply_to_tweet_id":{"type":"string"}}},"logicalName":"x_write","displayName":"x_write","title":"x_write","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["action","account"],"properties":{"type":{"type":"string"},"maxId":{"type":"string"},"action":{"enum":["bookmarks","bookmark_folders","notifications","dm_history"],"type":"string"},"account":{"type":"string"},"folderId":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1},"target_user_id":{"type":"string"}}},"logicalName":"x_inbox","displayName":"x_inbox","title":"x_inbox","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["action","account"],"properties":{"url":{"type":"string"},"name":{"type":"string"},"action":{"enum":["update_profile","set_avatar","set_banner"],"type":"string"},"account":{"type":"string"},"location":{"type":"string"},"media_url":{"type":"string"}}},"logicalName":"x_profile","displayName":"x_profile","title":"x_profile","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["action","account"],"properties":{"name":{"type":"string"},"action":{"enum":["create","join","leave","delete"],"type":"string"},"account":{"type":"string"},"community_id":{"type":"string"},"community_name":{"type":"string"}}},"logicalName":"x_community","displayName":"x_community","title":"x_community","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","properties":{"after":{"type":"string"},"hours":{"type":"integer"},"limit":{"type":"integer"},"region":{"type":"string"},"source":{"enum":["github","google_trends","hacker_news","polymarket","reddit","trustmrr","wikipedia"],"type":"string"},"category":{"enum":["general","tech","dev","science","culture","politics","business","entertainment"],"type":"string"}}},"logicalName":"x_radar","displayName":"x_radar","title":"x_radar","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"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.","inputSchema":{"type":"object","required":["step"],"properties":{"goal":{"type":"string"},"step":{"enum":["generate","refine","score"],"type":"string"},"tone":{"type":"string"},"draft":{"type":"string"},"topic":{"type":"string"},"hasLink":{"type":"boolean"},"hasMedia":{"type":"boolean"},"mediaType":{"type":"string"},"callToAction":{"type":"string"},"styleUsername":{"type":"string"},"additionalContext":{"type":"string"}}},"logicalName":"x_compose","displayName":"x_compose","title":"x_compose","annotations":{"untrustedContentHint":true,"readOnlyHint":true}}],"toolSource":"directory_preview","agentAction":"both","installLinks":[{"id":"cursor","label":"Cursor","href":"cursor://anysphere.cursor-deeplink/mcp/install?name=twitr-sh-pay-per-call-X-Twitter-API-for-AI-agents&config=eyJ1cmwiOiAiaHR0cHM6Ly90d2l0ci5zaC9hcGkvbWNwIn0%3D"},{"id":"vscode","label":"VS Code","href":"vscode:mcp/install?%7B%22name%22%3A%22twitr-sh-pay-per-call-X-Twitter-API-for-AI-agents%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ftwitr.sh%2Fapi%2Fmcp%22%7D"},{"id":"vscode-insiders","label":"VS Code Insiders","href":"vscode-insiders:mcp/install?%7B%22name%22%3A%22twitr-sh-pay-per-call-X-Twitter-API-for-AI-agents%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ftwitr.sh%2Fapi%2Fmcp%22%7D"},{"id":"claude-web","label":"Claude.ai","href":"https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=twitr.sh+%E2%80%94+pay-per-call+X%2FTwitter+API+for+AI+agents&connectorUrl=https%3A%2F%2Ftwitr.sh%2Fapi%2Fmcp"},{"id":"codex","label":"Codex","copyText":"codex mcp add \"twitr-sh-pay-per-call-X-Twitter-API-for-AI-agents\" --url \"https://twitr.sh/api/mcp\""},{"id":"chatgpt","label":"ChatGPT","href":"https://www.mcpbundles.com/docs/integrations/chatgpt"}],"catalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/twitr-mcp-e0adb4b1bd","callUrl":"https://www.mcpbundles.com/api/directory/v1/servers/twitr-mcp-e0adb4b1bd/tools/{tool}","mcpServerUrl":"https://twitr.sh/api/mcp","liveCatalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/twitr-mcp-e0adb4b1bd?live=1"}