productivity
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.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.
Agent Surfaces
Machine-Readable Metadata
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 |