social
Twitter / X MCP, CLI, and Lua Integration for AI Agents
Twitter / X integration docs for AI agents: MCP gateway setup, Twitter / X CLI commands, Lua API reference, credentials, and function schemas.
162 functions 96 read 66 write multi auth auth
Twitter / X for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
x- route_slug
x- package
x- auth_strategy
multi_authmulti auth- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. Twitter / X CLIHeadless setup and direct function calls. Twitter / X MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Twitter / X MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Twitter / X.
Claude Code Twitter / X MCP setup for Claude Code. Cursor Twitter / X MCP setup for Cursor. Codex Twitter / X MCP setup for Codex. OpenAI Agents Twitter / X MCP setup for OpenAI Agents SDK. Claude Agent SDK Twitter / X MCP setup for Claude Agent SDK. Vercel AI SDK Twitter / X MCP setup for Vercel AI SDK. LangChain Twitter / X MCP setup for LangChain. LangGraph Twitter / X MCP setup for LangGraph. CrewAI Twitter / X MCP setup for CrewAI. MCP clients Twitter / X MCP setup for Generic MCP Clients.
Twitter / X CLI Matrix
Use these pages for direct Twitter / X CLI workflows in scripts, CI, cron, and agent wrappers.
CI Twitter / X CLI for CI. Cron Jobs Twitter / X CLI for cron jobs. Shell Scripts Twitter / X CLI for shell scripts. Headless Automation Twitter / X CLI for headless automation. Coding Agents Twitter / X CLI for coding agents.
Runtime Requirements
| Name | Type | Description |
|---|---|---|
streaming_runner | host_capability | Required for tools marked runtime_mode=stream. |
public_webhook_endpoint | host_capability | Required for webhook and account-activity subscription operations. |
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
x.x_get_account_activity_subscription_count | Read read | 0 | Get subscription count |
x.x_validate_account_activity_subscription | Read read | 1 | Validate subscription |
x.x_create_account_activity_subscription | Write write | 2 | Create subscription |
x.x_get_account_activity_subscriptions | Read read | 1 | Get subscriptions |
x.x_delete_account_activity_subscription | Write write | 2 | Delete subscription |
x.x_activity_stream | Read read | 3 | Activity Stream |
x.x_delete_activity_subscriptions_by_ids | Write write | 1 | Delete X activity subscriptions by IDs |
x.x_get_activity_subscriptions | Read read | 2 | Get X activity subscriptions |
x.x_create_activity_subscription | Write write | 1 | Create X activity subscription |
x.x_delete_activity_subscription | Write write | 1 | Deletes X activity subscription |
x.x_update_activity_subscription | Write write | 2 | Update X activity subscription |
x.x_get_chat_conversations | Read read | 5 | Get Chat Conversations |
x.x_create_chat_conversation | Write write | 1 | Create Chat Group Conversation |
x.x_initialize_chat_group | Write write | 0 | Initialize Chat Group |
x.x_get_chat_conversation | Read read | 4 | Get Chat Conversation |
x.x_initialize_chat_conversation_keys | Write write | 2 | Initialize Conversation Keys |
x.x_add_chat_group_members | Write write | 2 | Add members to a Chat group conversation |
x.x_send_chat_message | Write write | 2 | Send Chat Message |
x.x_mark_chat_conversation_read | Write write | 2 | Mark Conversation as Read |
x.x_send_chat_typing_indicator | Write write | 1 | Send Typing Indicator |
x.x_chat_media_upload_initialize | Write write | 1 | Initialize Chat Media Upload |
x.x_chat_media_upload_append | Write write | 2 | Append Chat Media Upload |
x.x_chat_media_upload_finalize | Write write | 2 | Finalize Chat Media Upload |
x.x_chat_media_download | Read read | 2 | Download Chat Media |
x.x_search_communities | Read read | 5 | Search Communities |
x.x_get_communities_by_id | Read read | 2 | Get Community by ID |
x.x_get_compliance_jobs | Read read | 3 | Get Compliance Jobs |
x.x_create_compliance_jobs | Write write | 1 | Create Compliance Job |
x.x_get_compliance_jobs_by_id | Read read | 2 | Get Compliance Job by ID |
x.x_delete_connections_by_uuids | Write write | 1 | Terminate multiple connections |
x.x_get_connection_history | Read read | 5 | Get Connection History |
x.x_delete_all_connections | Write write | 0 | Terminate all connections |
x.x_delete_connections_by_endpoint | Write write | 1 | Terminate connections by endpoint |
x.x_create_direct_messages_conversation | Write write | 1 | Create DM conversation |
x.x_dm_conversations_media_download | Read read | 3 | Download DM Media |
x.x_get_direct_messages_events_by_participant_id | Read read | 9 | Get DM events for a DM conversation |
x.x_create_direct_messages_by_participant_id | Write write | 2 | Create DM message by participant ID |
x.x_create_direct_messages_by_conversation_id | Write write | 2 | Create DM message by conversation ID |
x.x_get_direct_messages_events_by_conversation_id | Read read | 9 | Get DM events for a DM conversation |
x.x_get_direct_messages_events | Read read | 8 | Get DM events |
x.x_delete_direct_messages_events | Write write | 1 | Delete DM event |
x.x_get_direct_messages_events_by_id | Read read | 6 | Get DM event by ID |
x.x_evaluate_community_notes | Write write | 1 | Evaluate a Community Note |
x.x_get_insights28_hr | Read read | 4 | Get 28-hour Post insights |
x.x_get_insights_historical | Read read | 6 | Get historical Post insights |
x.x_stream_likes_compliance | Read read | 3 | Stream Likes compliance data |
x.x_stream_likes_firehose | Read read | 9 | Stream all Likes |
x.x_stream_likes_sample10 | Read read | 9 | Stream sampled Likes |
x.x_create_lists | Write write | 1 | Create List |
x.x_delete_lists | Write write | 1 | Delete List |
x.x_get_lists_by_id | Read read | 4 | Get List by ID |
x.x_update_lists | Write write | 2 | Update List |
x.x_get_lists_followers | Read read | 6 | Get List followers |
x.x_get_lists_members | Read read | 6 | Get List members |
x.x_add_lists_member | Write write | 2 | Add List member |
x.x_remove_lists_member_by_user_id | Write write | 2 | Remove List member |
x.x_get_lists_posts | Read read | 9 | Get List Posts |
x.x_get_media_by_media_keys | Read read | 2 | Get Media by media keys |
x.x_get_media_analytics | Read read | 5 | Get Media analytics |
x.x_create_media_metadata | Write write | 1 | Create Media metadata |
x.x_delete_media_subtitles | Write write | 1 | Delete Media subtitles |
x.x_create_media_subtitles | Write write | 1 | Create Media subtitles |
x.x_get_media_upload_status | Read read | 2 | Get Media upload status |
x.x_media_upload | Write write | 1 | Upload media |
x.x_initialize_media_upload | Write write | 1 | Initialize media upload |
x.x_append_media_upload | Write write | 2 | Append Media upload |
x.x_finalize_media_upload | Write write | 1 | Finalize Media upload |
x.x_get_media_by_media_key | Read read | 2 | Get Media by media key |
x.x_search_news | Read read | 4 | Search News |
x.x_get_news | Read read | 2 | Get news stories by ID |
x.x_create_community_notes | Write write | 1 | Create a Community Note |
x.x_search_community_notes_written | Read read | 4 | Search for Community Notes Written |
x.x_search_eligible_posts | Read read | 10 | Search for Posts Eligible for Community Notes |
x.x_delete_community_notes | Write write | 1 | Delete a Community Note |
x.x_get_open_api_spec | Read read | 0 | Get OpenAPI Spec. |
x.x_get_spaces_by_ids | Read read | 5 | Get Spaces by IDs |
x.x_get_spaces_by_creator_ids | Read read | 5 | Get Spaces by creator IDs |
x.x_search_spaces | Read read | 7 | Search Spaces |
x.x_get_spaces_by_id | Read read | 5 | Get space by ID |
x.x_get_spaces_buyers | Read read | 6 | Get Space ticket buyers |
x.x_get_spaces_posts | Read read | 8 | Get Space Posts |
x.x_get_trends_by_woeid | Read read | 3 | Get Trends by WOEID |
x.x_get_posts_by_ids | Read read | 7 | Get Posts by IDs |
x.x_create_posts | Write write | 1 | Create or Edit Post |
x.x_get_posts_analytics | Read read | 5 | Get Post analytics |
x.x_stream_posts_compliance | Read read | 4 | Stream Posts compliance data |
x.x_get_posts_counts_all | Read read | 9 | Get count of all Posts |
x.x_get_posts_counts_recent | Read read | 9 | Get count of recent Posts |
x.x_stream_posts_firehose | Read read | 10 | Stream all Posts |
x.x_stream_posts_firehose_en | Read read | 10 | Stream English Posts |
x.x_stream_posts_firehose_ja | Read read | 10 | Stream Japanese Posts |
x.x_stream_posts_firehose_ko | Read read | 10 | Stream Korean Posts |
x.x_stream_posts_firehose_pt | Read read | 10 | Stream Portuguese Posts |
x.x_stream_labels_compliance | Read read | 3 | Stream Post labels |
x.x_stream_posts_sample | Read read | 7 | Stream sampled Posts |
x.x_stream_posts_sample10 | Read read | 10 | Stream 10% sampled Posts |
x.x_search_posts_all | Read read | 15 | Search all Posts |
x.x_search_posts_recent | Read read | 15 | Search recent Posts |
x.x_stream_posts | Read read | 9 | Stream filtered Posts |
x.x_get_rules | Read read | 3 | Get stream rules |
x.x_update_rules | Write write | 3 | Update stream rules |
x.x_get_rule_counts | Read read | 1 | Get stream rule counts |
x.x_get_webhooks_stream_links | Read read | 0 | Get stream links |
x.x_delete_webhooks_stream_link | Write write | 1 | Delete stream link |
x.x_create_webhooks_stream_link | Write write | 7 | Create stream link |
x.x_delete_posts | Write write | 1 | Delete Post |
x.x_get_posts_by_id | Read read | 7 | Get Post by ID |
x.x_get_posts_liking_users | Read read | 6 | Get Liking Users |
x.x_get_posts_quoted_posts | Read read | 10 | Get Quoted Posts |
x.x_get_posts_reposted_by | Read read | 6 | Get Reposted by |
x.x_get_posts_reposts | Read read | 9 | Get Reposts |
x.x_hide_posts_reply | Write write | 2 | Hide reply |
x.x_get_usage | Read read | 2 | Get usage |
x.x_get_users_by_ids | Read read | 4 | Get Users by IDs |
x.x_get_users_by_usernames | Read read | 4 | Get Users by usernames |
x.x_get_users_by_username | Read read | 4 | Get User by username |
x.x_stream_users_compliance | Read read | 4 | Stream Users compliance data |
x.x_get_users_me | Read read | 3 | Get my User |
x.x_get_trends_personalized_trends | Read read | 1 | Get personalized Trends |
x.x_get_users_public_keys | Read read | 2 | Get public keys for multiple users |
x.x_get_users_reposts_of_me | Read read | 8 | Get Reposts of me |
x.x_search_users | Read read | 6 | Search Users |
x.x_get_users_by_id | Read read | 4 | Get User by ID |
x.x_get_users_affiliates | Read read | 6 | Get affiliates |
x.x_get_users_blocking | Read read | 6 | Get blocking |
x.x_get_users_bookmarks | Read read | 9 | Get Bookmarks |
x.x_create_users_bookmark | Write write | 2 | Create Bookmark |
x.x_get_users_bookmark_folders | Read read | 3 | Get Bookmark folders |
x.x_get_users_bookmarks_by_folder_id | Read read | 2 | Get Bookmarks by folder ID |
x.x_delete_users_bookmark | Write write | 2 | Delete Bookmark |
x.x_block_users_dms | Write write | 1 | Block DMs |
x.x_unblock_users_dms | Write write | 1 | Unblock DMs |
x.x_get_users_followed_lists | Read read | 6 | Get followed Lists |
x.x_follow_list | Write write | 2 | Follow List |
x.x_unfollow_list | Write write | 2 | Unfollow List |
x.x_get_users_followers | Read read | 6 | Get followers |
x.x_get_users_following | Read read | 6 | Get following |
x.x_follow_user | Write write | 2 | Follow User |
x.x_get_users_liked_posts | Read read | 9 | Get liked Posts |
x.x_like_post | Write write | 2 | Like Post |
x.x_unlike_post | Write write | 2 | Unlike Post |
x.x_get_users_list_memberships | Read read | 6 | Get List memberships |
x.x_get_users_mentions | Read read | 13 | Get mentions |
x.x_get_users_muting | Read read | 6 | Get muting |
x.x_mute_user | Write write | 2 | Mute User |
x.x_get_users_owned_lists | Read read | 6 | Get owned Lists |
x.x_get_users_pinned_lists | Read read | 4 | Get pinned Lists |
x.x_pin_list | Write write | 2 | Pin List |
x.x_unpin_list | Write write | 2 | Unpin List |
x.x_get_users_public_key | Read read | 2 | Get user public keys |
x.x_add_user_public_key | Write write | 2 | Add public key |
x.x_repost_post | Write write | 2 | Repost Post |
x.x_unrepost_post | Write write | 2 | Unrepost Post |
x.x_get_users_timeline | Read read | 14 | Get Timeline |
x.x_get_users_posts | Read read | 14 | Get Posts |
x.x_unfollow_user | Write write | 2 | Unfollow User |
x.x_unmute_user | Write write | 2 | Unmute User |
x.x_get_webhooks | Read read | 1 | Get webhook |
x.x_create_webhooks | Write write | 1 | Create webhook |
x.x_create_webhook_replay_job | Write write | 1 | Create replay job for webhook |
x.x_delete_webhooks | Write write | 1 | Delete webhook |
x.x_validate_webhooks | Write write | 1 | Validate webhook |