X-Use - X (Twitter) MCP Server
ihuzaifashoukat/x-use
Research X (Twitter), read inboxes and review publishing through MCP. No X API key required.
- GitHub stars
- 181
- tools
- 31
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Oct 13, 2026
Tools
31 toolsPublic tool metadata for what this MCP can expose to an agent.
get_profile_contextProfile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
Profile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
No parameter schema in public metadata yet.
search_profileProfile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
Profile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
No parameter schema in public metadata yet.
search_tweetsProfile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
Profile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
No parameter schema in public metadata yet.
get_tweetProfile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
Profile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
No parameter schema in public metadata yet.
get_threadProfile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
Profile and post research workflow tool exposing visible profile, post, media and bounded thread evidence.
No parameter schema in public metadata yet.
get_inboxInbox and notifications workflow tool covering inbox/request folders and read-state evidence.
Inbox and notifications workflow tool covering inbox/request folders and read-state evidence.
No parameter schema in public metadata yet.
search_conversationsInbox and notifications workflow tool covering inbox/request folders and read-state evidence.
Inbox and notifications workflow tool covering inbox/request folders and read-state evidence.
No parameter schema in public metadata yet.
get_conversationInbox and notifications workflow tool covering inbox/request folders and read-state evidence.
Inbox and notifications workflow tool covering inbox/request folders and read-state evidence.
No parameter schema in public metadata yet.
get_notificationsInbox and notifications workflow tool covering inbox/request folders and read-state evidence.
Inbox and notifications workflow tool covering inbox/request folders and read-state evidence.
No parameter schema in public metadata yet.
get_bookmarksReviewed changes to publishing and inbox controls.
Reviewed changes to publishing and inbox controls.
No parameter schema in public metadata yet.
edit_tweetReviewed changes to publishing and inbox controls.
Reviewed changes to publishing and inbox controls.
No parameter schema in public metadata yet.
delete_tweetReviewed changes to publishing and inbox controls.
Reviewed changes to publishing and inbox controls.
No parameter schema in public metadata yet.
unfollow_profileReviewed changes to publishing and inbox controls.
Reviewed changes to publishing and inbox controls.
No parameter schema in public metadata yet.
manage_conversationReviewed changes to publishing and inbox controls.
Reviewed changes to publishing and inbox controls.
No parameter schema in public metadata yet.
post_tweetReviewed publishing with persistent drafts and resumable thread progress.
Reviewed publishing with persistent drafts and resumable thread progress.
No parameter schema in public metadata yet.
reply_to_tweetReviewed publishing with persistent drafts and resumable thread progress.
Reviewed publishing with persistent drafts and resumable thread progress.
No parameter schema in public metadata yet.
prepare_threadReviewed publishing with persistent drafts and resumable thread progress.
Reviewed publishing with persistent drafts and resumable thread progress.
No parameter schema in public metadata yet.
approve_draftReviewed publishing with persistent drafts and resumable thread progress.
Reviewed publishing with persistent drafts and resumable thread progress.
No parameter schema in public metadata yet.
prepare_outreachIndividual outreach where message and follow drafts require individual approval.
Individual outreach where message and follow drafts require individual approval.
No parameter schema in public metadata yet.
send_messageIndividual outreach where message and follow drafts require individual approval.
Individual outreach where message and follow drafts require individual approval.
No parameter schema in public metadata yet.
follow_profileIndividual outreach where message and follow drafts require individual approval.
Individual outreach where message and follow drafts require individual approval.
No parameter schema in public metadata yet.
upsert_leadLocal lead records, suppression and bounded batches.
Local lead records, suppression and bounded batches.
No parameter schema in public metadata yet.
create_campaignLocal lead records, suppression and bounded batches.
Local lead records, suppression and bounded batches.
No parameter schema in public metadata yet.
prepare_campaign_messagesLocal lead records, suppression and bounded batches.
Local lead records, suppression and bounded batches.
No parameter schema in public metadata yet.
opt_out_leadLocal lead records, suppression and bounded batches.
Local lead records, suppression and bounded batches.
No parameter schema in public metadata yet.
get_account_healthOperational account readiness score, evidence and recovery advice.
Operational account readiness score, evidence and recovery advice.
No parameter schema in public metadata yet.
get_session_statusAccount readiness check for session status.
Account readiness check for session status.
No parameter schema in public metadata yet.
test_proxyExplicit proxy connectivity check.
Explicit proxy connectivity check.
No parameter schema in public metadata yet.
queue_postScheduling and recovery tool with durable budgets and uncertain-outcome tracking.
Scheduling and recovery tool with durable budgets and uncertain-outcome tracking.
No parameter schema in public metadata yet.
process_queueScheduling and recovery tool with durable budgets and uncertain-outcome tracking.
Scheduling and recovery tool with durable budgets and uncertain-outcome tracking.
No parameter schema in public metadata yet.
resolve_action_outcomeScheduling and recovery tool with durable budgets and uncertain-outcome tracking.
Scheduling and recovery tool with durable budgets and uncertain-outcome tracking.
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
X_USE_HOMEAbsolute private directory for configuration, cookies, action journals and account state. Keep this stable across MCP client working directories.
OPENAI_API_KEYsecretOptional. Only needed for server-side text generation ('auto' replies, composite draft tools, background automation). Interactive MCP use is keyless because the calling agent writes the text.
OPENAI_BASE_URLOptional. OpenAI-compatible endpoint, for example https://openrouter.ai/api/v1 or http://localhost:11434/v1 for Ollama. Defaults to api.openai.com.
Readme
x-use — MCP server for X (Twitter)
Connect your AI client to X research, inbox reads, and reviewed publishing.
x-use is an open-source Python Model Context Protocol (MCP) server and CLI for X (Twitter). Connect Claude, Codex, Cursor or another local MCP client to profile research, inbox management and reviewed publishing. It uses your authenticated browser session, supports multiple accounts and runs locally without official X API credentials.
Details
- Repository
- github.com/ihuzaifashoukat/x-use
- Website
- github.com/ihuzaifashoukat/x-use
- Category
- Media & Entertainment
- Package
x-use-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
