twit-mcp

Real-time X/Twitter data and write actions via x402 micropayments. Fetch articles, tweets, users, lists, and communities — post tweets, like, retweet, bookma...

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:

1. Call connect_twitter — a Chrome window will open at x.com
2. The user logs in if prompted
3. Once confirmed, credentials are saved locally to ~/.twit-mcp-credentials.json
4. 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