Home / Servers / X (Twitter) API
X (Twitter) API MCP server
Posts, users, searches, lists and spaces on X.
The X API v2 from its OpenAPI description: look up posts and users, search recent posts, timelines, likes, lists, spaces, trends and compliance jobs. An app-only bearer token covers reads; posting needs a user token.
Why use the hosted one: Every endpoint of X's API behind the gateway's search, with your own X API bearer token stored encrypted and sent only to X.
Needs your X API bearer token: add it once in the dashboard (get one at X). It is stored encrypted and sent only to that API.
Connect
claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
--header "Authorization: Bearer YOUR_API_KEY"Create an API key and put it in place of YOUR_API_KEY. Step-by-step guides: claude.ai and ChatGPT connectors, Claude Code, Cursor, VS Code, Claude Desktop, Windsurf, Zed, OpenAI Codex CLI, Gemini CLI.
All 258 tools
Get 92 tools
- Get Developer Account
get_developer_account - Get Subscription Count
get_account_activity_subscription_count - Get Subscriptions
get_account_activity_subscriptions - Get X Activity Subscriptions
get_activity_subscriptions - Get Bots
get_bots - Get Chat Moderators
get_chat_moderators - Get Muted Chat Users
get_chat_muted_users - Get a Scheduled Broadcast
get_scheduled_broadcast - Get a Broadcast
get_broadcast - Get Broadcast Chat History
get_broadcast_chat - Get a Scheduled Call
get_scheduled_call - Get a Call
get_call - Get Chat Conversations
get_chat_conversations - Get Chat Conversation
get_chat_conversation - Get Pending Admin Requests for a Chat Group Conversation
get_chat_group_admin_requests - Get Chat Conversation Events
get_chat_conversation_events - Get a Chat Group Invite Link
get_chat_group_invite - Get Chat Conversation Pinned Messages
get_chat_conversation_pinned_messages - Get Chat Message Requests
get_chat_message_requests - Get Chat Message Request
get_chat_message_request - Get Chat Settings
get_chat_settings - Get Community by ID
get_communities_by_id - Get Compliance Jobs
get_compliance_jobs - Get Compliance Job by ID
get_compliance_jobs_by_id - Get Connection History
get_connection_history - Get DM Events by Participant ID
get_direct_messages_events_by_participant_id - Get DM Events by Conversation ID
get_direct_messages_events_by_conversation_id - Get DM Events
get_direct_messages_events - Get DM Event by ID
get_direct_messages_events_by_id - Get List by ID
get_lists_by_id - Get List Followers
get_lists_followers - Get List Members
get_lists_members - Get List Posts
get_lists_posts - Get Media by Media Keys
get_media_by_media_keys - Get Media Analytics
get_media_analytics - Get Media Upload Status
get_media_upload_status - Get Media by Media Key
get_media_by_media_key - Get News Stories by ID
get_news - Get OpenAPI Spec
get_open_api_spec - Get the Ingest Region
get_region - Get a Stream Source
get_source - Get a Stream Source's Stream Key
get_source_stream_key - Get Spaces by IDs
get_spaces_by_ids - Get Spaces by Creator IDs
get_spaces_by_creator_ids - Get Space by ID
get_spaces_by_id - Get Space Ticket Buyers
get_spaces_buyers - Get Space Posts
get_spaces_posts - Get Trends by WOEID
get_trends_by_woeid - Get Posts by IDs
get_posts_by_ids - Get Post Analytics
get_posts_analytics - Get Count of All Posts
get_posts_counts_all - Get Count of Recent Posts
get_posts_counts_recent - Get Stream Rules
get_rules - Get Stream Rule Counts
get_rule_counts - Get Stream Links
get_webhooks_stream_links - Get Post by ID
get_posts_by_id - Get Liking Users
get_posts_liking_users - Get Quoted Posts
get_posts_quoted_posts - Get Reposted By
get_posts_reposted_by - Get Reposts
get_posts_reposts - Get Usage Credits
get_usage_credits - Get Usage
get_usage - Get Users by IDs
get_users_by_ids - Get Users by Usernames
get_users_by_usernames - Get User by Username
get_users_by_username - Get My User
get_users_me - Get the Authenticated User's Followers
get_users_me_followers - Get the Users the Authenticated User Follows
get_users_me_following - Get Personalized Trends
get_trends_personalized_trends - Get Public Keys for Multiple Users
get_users_public_keys - Get Reposts of Me
get_users_reposts_of_me - Get User by ID
get_users_by_id - Get Affiliates
get_users_affiliates - Get Blocked Users
get_users_blocking - Get Bookmarks
get_users_bookmarks - Get Bookmark Folders
get_users_bookmark_folders - Get Bookmarks by Folder ID
get_users_bookmarks_by_folder_id - Get a User's Broadcast
get_user_broadcast - Get Followed Lists
get_users_followed_lists - Get Followers
get_users_followers - Get Following
get_users_following - Get Liked Posts
get_users_liked_posts - Get List Memberships
get_users_list_memberships - Get Mentions
get_users_mentions - Get Muting
get_users_muting - Get Owned Lists
get_users_owned_lists - Get Pinned Lists
get_users_pinned_lists - Get User Public Keys
get_users_public_key - Get a User's Stream Source
get_user_source - Get Timeline
get_users_timeline - Get Posts
get_users_posts - Get Webhook
get_webhooks
Create 25 tools
- Create Subscription
create_account_activity_subscription - Create X Activity Subscription
create_activity_subscription - Create a Bot
create_bot - Create a Scheduled Broadcast
create_scheduled_broadcast - Create a Call
create_call - Create Chat Group Conversation
create_chat_conversation - Request Admin Permissions in a Chat Group Conversation
create_chat_group_admin_request - Request to Join a Chat Group
create_chat_group_join_request - Create Compliance Job
create_compliance_jobs - Create DM Conversation
create_direct_messages_conversation - Create DM Message by Participant ID
create_direct_messages_by_participant_id - Create DM Message by Conversation ID
create_direct_messages_by_conversation_id - Create List
create_lists - Create Media Metadata
create_media_metadata - Create Media Subtitles
create_media_subtitles - Create a Community Note
create_community_notes - Create a Stream Source
create_source - Create or Edit Post
create_posts - Create Stream Link
create_webhooks_stream_link - Create Bookmark
create_users_bookmark - Create Bookmark Folder
create_users_bookmark_folder - Create a Broadcast on a User's Source
create_user_broadcast - Create a Stream Source for a User
create_user_source - Create Webhook
create_webhooks - Create Replay Job for Webhook
create_webhook_replay_job
Delete 25 tools
- Delete Subscription
delete_account_activity_subscription - Delete X Activity Subscriptions by IDs
delete_activity_subscriptions_by_ids - Delete X Activity Subscription
delete_activity_subscription - Delete Bot
delete_bot - Delete a Scheduled Broadcast
delete_scheduled_broadcast - Delete a Broadcast
delete_broadcast - Remove a Chat Message from a Live Broadcast
delete_broadcast_chat_message - Delete a Chat Conversation
delete_chat_conversation - Turn Off Disappearing Messages in a Chat Conversation
delete_chat_conversation_message_ttl - Delete Chat Messages
delete_chat_messages - Cancel Compliance Job
delete_compliance_jobs_by_id - Terminate Multiple Connections
delete_connections_by_uuids - Terminate All Connections
delete_all_connections - Terminate Connections by Endpoint
delete_connections_by_endpoint - Delete DM Event
delete_direct_messages_events - Delete List
delete_lists - Delete Media Subtitles
delete_media_subtitles - Delete a Community Note
delete_community_notes - Delete a Stream Source
delete_source - Delete Stream Link
delete_webhooks_stream_link - Delete Post
delete_posts - Delete Bookmark
delete_users_bookmark - Delete a User's Broadcast
delete_user_broadcast - Delete a User's Stream Source
delete_user_source - Delete Webhook
delete_webhooks
Update 15 tools
- Update X Activity Subscription
update_activity_subscription - Update Bot
update_bot - Update a Scheduled Broadcast
update_scheduled_broadcast - End a Broadcast
update_broadcast_state - Update a Scheduled Call
update_scheduled_call - Update a Chat Group Conversation
update_chat_group - Update the Admin-Only Settings of a Chat Group Conversation
update_chat_group_admin_settings - Turn On Disappearing Messages in a Chat Conversation
update_chat_conversation_message_ttl - Update Screen Capture Settings for a Chat Conversation
update_chat_conversation_screen_capture - Update Chat Settings
update_chat_settings - Update List
update_lists - Rename a Stream Source
update_source - Update Stream Rules
update_rules - Publish or End a User's Broadcast
update_user_broadcast_state - Rename a User's Stream Source
update_user_source
Stream 14 tools
- Stream Likes Compliance Data
stream_likes_compliance - Stream All Likes
stream_likes_firehose - Stream Sampled Likes
stream_likes_sample10 - Stream Posts Compliance Data
stream_posts_compliance - Stream All Posts
stream_posts_firehose - Stream English Posts
stream_posts_firehose_en - Stream Japanese Posts
stream_posts_firehose_ja - Stream Korean Posts
stream_posts_firehose_ko - Stream Portuguese Posts
stream_posts_firehose_pt - Stream Post Labels
stream_labels_compliance - Stream Sampled Posts
stream_posts_sample - Stream 10% Sampled Posts
stream_posts_sample10 - Stream Filtered Posts
stream_posts - Stream Users Compliance Data
stream_users_compliance
Search 8 tools
- Search Communities
search_communities - Search News
search_news - Search for Community Notes Written
search_community_notes_written - Search for Posts Eligible for Community Notes
search_eligible_posts - Search Spaces
search_spaces - Search All Posts
search_posts_all - Search Recent Posts
search_posts_recent - Search Users
search_users
Add 6 tools
- Add a Chat Moderator
add_chat_moderator - Add Admins to a Chat Group Conversation
add_chat_group_admins - Add Conversation Keys
add_conversation_keys - Add Members to a Chat Group Conversation
add_chat_group_members - Add List Member
add_lists_member - Add Public Key
add_user_public_key
List 6 tools
- List Broadcasts
list_broadcasts - List Scheduled Broadcasts
list_scheduled_broadcasts - List Scheduled Calls
list_scheduled_calls - List Stream Sources
list_sources - List a User's Broadcasts
list_user_broadcasts - List a User's Stream Sources
list_user_sources
Chat 4 tools
- Initialize Chat Media Upload
chat_media_upload_initialize - Append Chat Media Upload
chat_media_upload_append - Finalize Chat Media Upload
chat_media_upload_finalize - Download Chat Media
chat_media_download
Mute 4 tools
- Mute or Time Out a User in Chat
mute_chat_user - Mute or Time Out a User in a Broadcast Chat
mute_broadcast_chat_user - Mute a Chat Conversation
mute_chat_conversation - Mute User
mute_user
Remove 4 tools
- Remove a Chat Moderator
remove_chat_moderator - Remove Admins from a Chat Group Conversation
remove_chat_group_admins - Remove Members from a Chat Group Conversation
remove_chat_group_members - Remove List Member
remove_lists_member_by_user_id
Unmute 4 tools
- Unmute a User in Chat
unmute_chat_user - Unmute a User in a Broadcast Chat
unmute_broadcast_chat_user - Unmute a Chat Conversation
unmute_chat_conversation - Unmute User
unmute_user
Send 3 tools
- Send a Chat Message to a Live Broadcast
send_broadcast_chat - Send Chat Message
send_chat_message - Send Typing Indicator
send_chat_typing_indicator
Article 2 tools
- Create Draft Article
article_create_draft - Publish Article
article_publish
Follow 2 tools
- Follow List
follow_list - Follow User
follow_user
Initialize 2 tools
- Initialize Chat Group
initialize_chat_group - Initialize Media Upload
initialize_media_upload
Mark 2 tools
- Mark Conversation as Read
mark_chat_conversation_read - Mark Conversation as Unread
mark_chat_conversation_unread
Reject 2 tools
- Reject an Admin Request in a Chat Group Conversation
reject_chat_group_admin_request - Reject Join Requests for a Chat Group Conversation
reject_chat_group_join_requests
Unfollow 2 tools
- Unfollow List
unfollow_list - Unfollow User
unfollow_user
Users 2 tools
- Block User
users_id_block - Unblock User
users_id_unblock
Validate 2 tools
- Validate Subscription
validate_account_activity_subscription - Validate Webhook
validate_webhooks
Accept 1 tool
- Accept a Chat Message Request
accept_chat_message_request
Activity 1 tool
- Activity Stream
activity_stream
Append 1 tool
- Append Media Upload
append_media_upload
Approve 1 tool
- Approve an Admin Request in a Chat Group Conversation
approve_chat_group_admin_request
Archive 1 tool
- Archive a Chat Conversation
archive_chat_conversation
Block 1 tool
- Block DMs
block_users_dms
Cancel 1 tool
- Cancel a Scheduled Call
cancel_scheduled_call
Disable 1 tool
- Disable a Chat Group Invite Link
disable_chat_group_invite
Dm 1 tool
- Download DM Media
dm_conversations_media_download
Download 1 tool
- Download Compliance Job Results
download_compliance_job_results
Enable 1 tool
- Enable a Chat Group Invite Link
enable_chat_group_invite
Ensure 1 tool
- Ensure Developer Account
ensure_account
Evaluate 1 tool
- Evaluate a Community Note
evaluate_community_notes
Finalize 1 tool
- Finalize Media Upload
finalize_media_upload
Go 1 tool
- Go Live on a Scheduled Broadcast
go_live_scheduled_broadcast
Hide 1 tool
- Hide Reply
hide_posts_reply
Join 1 tool
- Join a Call
join_call
Leave 1 tool
- Leave a Call
leave_call
Like 1 tool
- Like Post
like_post
Media 1 tool
- Upload Media
media_upload
Pin 1 tool
- Pin List
pin_list
Repost 1 tool
- Repost Post
repost_post
Respond 1 tool
- Respond to a Scheduled Call
respond_to_scheduled_call
Revoke 1 tool
- Revoke Bot Token
revoke_bot_token
Rotate 1 tool
- Rotate Bot Token
rotate_bot_token
Schedule 1 tool
- Schedule a Call
schedule_call
Unarchive 1 tool
- Unarchive a Chat Conversation
unarchive_chat_conversation
Unblock 1 tool
- Unblock DMs
unblock_users_dms
Unlike 1 tool
- Unlike Post
unlike_post
Unpin 1 tool
- Unpin List
unpin_list
Unrepost 1 tool
- Unrepost Post
unrepost_post
Upload 1 tool
- Upload Compliance Job Submission
upload_compliance_job_submission
Try asking
Search the last week of posts mentioning "model context protocol" and summarise the themes.
Usage and limits
Every account gets a free daily allowance of tool calls; connecting, listing and searching are not counted. See the limits. Only a tool that runs costs a call.