twit-mcp
// Real-time X/Twitter data via x402 micropayments. Look up users, fetch tweets, search the full archive — pay per request in USDC on Base. No API keys required.
twit-mcp
You have access to real-time X/Twitter data and write actions through this MCP server. Each tool call costs $0.0025–$0.01 USDC, paid automatically from the configured wallet on Base. No API key is required.
Available Tools
Articles
| Tool | Description | Price |
|---|---|---|
get_article_by_id | Get the full content of an X Article as Markdown by tweet ID. Not in official X API. | $0.01 USDC |
Tweets
| Tool | Description | Price |
|---|---|---|
get_tweet_by_id | Get a tweet by its ID | $0.0025 USDC |
get_user_tweets | Get a user's recent tweets (paginated) | $0.01 USDC |
get_tweet_replies | Get replies to a tweet (paginated) | $0.01 USDC |
get_tweet_quote_tweets | Get quote tweets for a tweet (paginated) | $0.01 USDC |
get_tweet_retweeted_by | Get users who reposted a tweet (paginated) | $0.01 USDC |
search_tweets | Full-archive tweet search with filters | $0.01 USDC |
get_tweets | Bulk lookup up to 50 tweets by ID | $0.01 USDC |
post_tweet | Post a new tweet as the authenticated user | $0.0025 USDC |
delete_tweet | Delete a tweet owned by the authenticated user | $0.0025 USDC |
like_tweet | Like a tweet as the authenticated user | $0.0075 USDC |
unlike_tweet | Unlike a tweet as the authenticated user | $0.005 USDC |
bookmark_tweet | Bookmark a tweet | $0.0025 USDC |
unbookmark_tweet | Remove a tweet from bookmarks | $0.0025 USDC |
retweet | Repost a tweet as the authenticated user | $0.0075 USDC |
unretweet | Undo a repost | $0.005 USDC |
Users
| Tool | Description | Price |
|---|---|---|
get_user_by_username | Get a user profile by username | $0.005 USDC |
get_user_by_id | Get a user profile by numeric ID | $0.005 USDC |
search_users | Search users by keyword (paginated) | $0.01 USDC |
get_user_followers | Get a user's followers (paginated) | $0.01 USDC |
get_user_following | Get accounts a user follows (paginated) | $0.01 USDC |
get_users | Bulk lookup up to 50 users by ID | $0.01 USDC |
follow_user | Follow a user as the authenticated user | $0.0075 USDC |
unfollow_user | Unfollow a user as the authenticated user | $0.005 USDC |
Lists
| Tool | Description | Price |
|---|---|---|
get_list_by_id | Get list details by numeric ID | $0.0025 USDC |
get_list_members | Get members of a list (paginated) | $0.01 USDC |
get_list_followers | Get followers of a list (paginated) | $0.01 USDC |
get_list_tweets | Get latest tweets from a list (paginated) | $0.01 USDC |
Communities
| Tool | Description | Price |
|---|---|---|
get_community_by_id | Get community details by ID. Not in official X API. | $0.0025 USDC |
get_community_posts | Get latest posts from a community (paginated). Not in official X API. | $0.01 USDC |
get_community_members | Get community members with roles (paginated). Not in official X API. | $0.01 USDC |
Twitter Auth
Write actions (post, delete, like, bookmark, retweet, follow) require a connected Twitter/X account. Before attempting any write action, call twitter_account_status to check if an account is connected.
| Tool | Description |
|---|---|
connect_twitter | Connect a Twitter/X account (opens a browser window) |
twitter_account_status | Check if a Twitter account is currently connected |
disconnect_twitter | Disconnect and clear stored credentials |
Connecting an account:
- Call
connect_twitter— a Chrome window will open at x.com - The user logs in if prompted
- Once confirmed, credentials are saved locally to
~/.twit-mcp-credentials.json - Write actions are available immediately — no restart needed
If a write action is requested and no account is connected, call connect_twitter first and wait for confirmation before proceeding.
How Payments Work
Each tool call makes an HTTP request to x402.twit.sh. The server responds with 402 Payment Required. The MCP server signs a USDC payment locally using the configured WALLET_PRIVATE_KEY and retries — all automatically, in one round-trip. The private key never leaves the machine.
Links
- twit.sh — API reference and pricing
- npm: twit-mcp
- x402.org — payment protocol docs