> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# X MCP

> Search posts, users, news, trends, Spaces, and communities, and manage lists, bookmarks, chats, broadcasts, calls, and Article drafts through X's hosted MCP server.

![X MCP logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/x_mcp.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=8cfd032dedf22fa7fd3f522cca0915d8)

* **Category:** model context protocol
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 96
* **Triggers:** 0
* **Slug:** `X_MCP`
* **Version:** 00000000\_00

## Tools

> [accordion] Accept chat message request
>
> **Slug:** `X_MCP_ACCEPT_CHAT_MESSAGE_REQUEST`
>
> Accept a Chat message request
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The other user's ID, or both user IDs joined by a hyphen.

> [accordion] Add chat moderator
>
> **Slug:** `X_MCP_ADD_CHAT_MODERATOR`
>
> Add a chat moderator
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The user to appoint as a moderator.

> [accordion] Add conversation keys
>
> **Slug:** `X_MCP_ADD_CONVERSATION_KEYS`
>
> Add Conversation Keys
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **action\_signatures** `array`
>
> Cryptographic signatures for the action.
>
> **conversation\_key\_version** `string` *required*
>
> Version of the conversation encryption key (typically a timestamp in milliseconds).
>
> **base64\_encoded\_key\_rotation** `string`
>
> Base64-encoded key rotation payload for ratchet tree key management.
>
> **conversation\_participant\_keys** `array` *required*
>
> Encrypted conversation keys for each participant.

> [accordion] Add lists member
>
> **Slug:** `X_MCP_ADD_LISTS_MEMBER`
>
> Add Lists Member
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **user\_id** `string` *required*

> [accordion] Archive chat conversation
>
> **Slug:** `X_MCP_ARCHIVE_CHAT_CONVERSATION`
>
> Archive a Chat conversation
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the conversation: a group ID starting with `g`, the other user's ID for a 1:1 conversat...
>
> **action\_signatures** `array`
>
> Cryptographic signatures for the action.

> [accordion] Article create draft
>
> **Slug:** `X_MCP_ARTICLE_CREATE_DRAFT`
>
> Create draft Article
>
> #### Input Parameters
>
> **title** `string` *required*
>
> The title of the Article.
>
> **cover\_media** `object`
>
> **content\_state** `object` *required*

> [accordion] Cancel scheduled call
>
> **Slug:** `X_MCP_CANCEL_SCHEDULED_CALL`
>
> Cancel a scheduled call
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **scope** `string ("all" | "this" | "this_and_following")`
>
> Which occurrences: all (the default without occurrence\_start\_time), this (the default with it), o...
>
> **notify\_invitees** `boolean`
>
> Whether invitees get an email about it. Defaults to true.
>
> **occurrence\_start\_time** `string`
>
> Start of the occurrence that scope this or this\_and\_following refers to (RFC 3339).

> [accordion] Chat media download
>
> **Slug:** `X_MCP_CHAT_MEDIA_DOWNLOAD`
>
> Download Chat Media. Returns JSON with the response bytes base64-encoded in `data`, plus `content_type` and `size_bytes`. Needs the OAuth2 scope `media.write`.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **media\_hash\_key** `string` *required*

> [accordion] Chat media upload append
>
> **Slug:** `X_MCP_CHAT_MEDIA_UPLOAD_APPEND`
>
> Append Chat Media Upload. Needs the OAuth2 scope `media.write`.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **media** `string` *required*
>
> The media segment bytes: base64-encoded in JSON bodies, raw bytes in multipart bodies.
>
> **segment\_index** `integer` *required*
>
> The index of this segment in the upload sequence.
>
> **media\_hash\_key** `string` *required*
>
> The media hash key returned by the initialize step.
>
> **conversation\_id** `string` *required*
>
> The XChat conversation the upload belongs to.

> [accordion] Chat media upload finalize
>
> **Slug:** `X_MCP_CHAT_MEDIA_UPLOAD_FINALIZE`
>
> Finalize Chat Media Upload. Needs the OAuth2 scope `media.write`.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **ttl\_msec** `string`
>
> Optional TTL for the media in milliseconds, as a numeric string.
>
> **num\_parts** `string` *required*
>
> Total number of uploaded parts, as a numeric string.
>
> **message\_id** `string`
>
> Optional message identifier associated with the upload.
>
> **media\_hash\_key** `string` *required*
>
> The media hash key returned by the initialize step.
>
> **conversation\_id** `string` *required*
>
> The XChat conversation the upload belongs to.

> [accordion] Chat media upload initialize
>
> **Slug:** `X_MCP_CHAT_MEDIA_UPLOAD_INITIALIZE`
>
> Initialize Chat Media Upload. Needs the OAuth2 scope `media.write`.
>
> #### Input Parameters
>
> **total\_bytes** `integer` *required*
>
> Total size of the media upload in bytes.
>
> **conversation\_id** `string` *required*
>
> The XChat conversation the upload belongs to.

> [accordion] Create lists
>
> **Slug:** `X_MCP_CREATE_LISTS`
>
> Create Lists
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the List (1-25 characters).
>
> **private** `boolean`
>
> Whether the List is private.
>
> **description** `string`
>
> Description of the List (up to 100 characters).

> [accordion] Create scheduled broadcast
>
> **Slug:** `X_MCP_CREATE_SCHEDULED_BROADCAST`
>
> Create a scheduled broadcast
>
> #### Input Parameters
>
> **title** `string`
>
> Title / status text.
>
> **locale** `string`
>
> Locale.
>
> **is\_locked** `boolean`
>
> Lock the broadcast.
>
> **source\_id** `string` *required*
>
> Ingest / source id to bind (same as sources `rtmp_stream_key`).
>
> **recurrence** `object`
>
> **chat\_option** `string`
>
> Who can chat (numeric string): `0` default, `1` chat off, `2` everyone, `3` verified accounts, \`4...
>
> **description** `string`
>
> Description.
>
> **telecast\_id** `string`
>
> Deprecated: telecast associations are being retired and this field will be ignored.
>
> **manual\_publish** `boolean`
>
> If true, do not auto-publish at start; call POST .../live when ready.
>
> **scheduled\_end\_ms** `string`
>
> Optional end time, ms since Unix epoch (decimal string). Omit for an open-ended broadcast.
>
> **scheduled\_start\_ms** `string` *required*
>
> Start time, ms since Unix epoch (decimal string).
>
> **thumbnail\_media\_id** `string`
>
> Pre-live slate media id (numeric string).
>
> **available\_for\_replay** `boolean`
>
> Enable replay.

> [accordion] Create source
>
> **Slug:** `X_MCP_CREATE_SOURCE`
>
> Create a stream source
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Label for the source.
>
> **region** `string` *required*
>
> Ingest region: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, sa-east-1, eu-west-1, eu...

> [accordion] Create users bookmark
>
> **Slug:** `X_MCP_CREATE_USERS_BOOKMARK`
>
> Create Bookmark
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **tweet\_id** `string`
>
> The ID of the Post to add to the user's Bookmarks. Mutually exclusive with `tweet_ids`.
>
> **folder\_id** `string`
>
> Optional ID of the Bookmark folder to add the Post(s) to. When omitted, Posts are added to the us...
>
> **tweet\_ids** `array`
>
> Post IDs to add to the user's Bookmarks. At most 25. Mutually exclusive with `tweet_id`.

> [accordion] Create users bookmark folder
>
> **Slug:** `X_MCP_CREATE_USERS_BOOKMARK_FOLDER`
>
> Create Bookmark Folder
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **name** `string` *required*
>
> Name of the Bookmark folder (1-25 characters).

> [accordion] Delete scheduled broadcast
>
> **Slug:** `X_MCP_DELETE_SCHEDULED_BROADCAST`
>
> Delete a scheduled broadcast
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **roll\_forward** `boolean`
>
> Deprecated: recurring schedules are being retired and `true` will be rejected.

> [accordion] Delete source
>
> **Slug:** `X_MCP_DELETE_SOURCE`
>
> Delete a stream source
>
> #### Input Parameters
>
> **id** `string` *required*

> [accordion] Delete users bookmark
>
> **Slug:** `X_MCP_DELETE_USERS_BOOKMARK`
>
> Delete Bookmark
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **tweet\_id** `string` *required*

> [accordion] Follow list
>
> **Slug:** `X_MCP_FOLLOW_LIST`
>
> Follow List
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **list\_id** `string` *required*

> [accordion] Get broadcast
>
> **Slug:** `X_MCP_GET_BROADCAST`
>
> Get a broadcast
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **broadcast.fields** `string`
>
> A comma separated list of Broadcast fields to display.

> [accordion] Get broadcast chat
>
> **Slug:** `X_MCP_GET_BROADCAST_CHAT`
>
> Get broadcast chat history
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A 64-bit signed integer.
>
> **broadcast\_chat\_message.fields** `string`
>
> A comma separated list of BroadcastChatMessage fields to display.

> [accordion] Get chat conversation
>
> **Slug:** `X_MCP_GET_CHAT_CONVERSATION`
>
> Get Chat Conversation; unread state via chat\_conversation.fields=unread,last\_read\_event\_id,newest\_event\_id
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **chat\_conversation.fields** `string`
>
> A comma separated list of ChatConversation fields to display.

> [accordion] Get chat conversation events
>
> **Slug:** `X_MCP_GET_CHAT_CONVERSATION_EVENTS`
>
> Get Chat Conversation Events, newest first; unread ones have an id above last\_read\_event\_id
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **max\_results** `integer`
>
> The maximum number of events to return.
>
> **pagination\_token** `string`
>
> The next\_token from a previous response, to fetch the next page.
>
> **chat\_message\_event.fields** `string`
>
> A comma separated list of ChatMessageEvent fields to display.

> [accordion] Get chat conversations
>
> **Slug:** `X_MCP_GET_CHAT_CONVERSATIONS`
>
> Get Chat Conversations; unread state via chat\_conversation.fields=unread,last\_read\_event\_id,newest\_event\_id
>
> #### Input Parameters
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **unread\_only** `boolean`
>
> Return only unread conversations. A page can be short; keep paging while has\_more.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> **chat\_conversation.fields** `string`
>
> A comma separated list of ChatConversation fields to display.

> [accordion] Get chat message request
>
> **Slug:** `X_MCP_GET_CHAT_MESSAGE_REQUEST`
>
> Get Chat Message Request
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The other user's ID, or both user IDs joined by a hyphen.
>
> **chat\_message\_request\_detail.fields** `string`
>
> A comma separated list of ChatMessageRequestDetail fields to display.

> [accordion] Get chat message requests
>
> **Slug:** `X_MCP_GET_CHAT_MESSAGE_REQUESTS`
>
> Get Chat Message Requests
>
> #### Input Parameters
>
> **inbox\_type** `string ("you_may_know" | "low_quality")`
>
> Which message request inbox to list: `you_may_know` (the apps' Priority tab) or `low_quality` (th...
>
> **max\_results** `integer`
>
> The maximum number of message requests to return.
>
> **pagination\_token** `string`
>
> The next\_token from a previous response, to fetch the next page.
>
> **chat\_message\_request.fields** `string`
>
> A comma separated list of ChatMessageRequest fields to display.

> [accordion] Get chat moderators
>
> **Slug:** `X_MCP_GET_CHAT_MODERATORS`
>
> Get chat moderators
>
> #### Input Parameters
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get communities by
>
> **Slug:** `X_MCP_GET_COMMUNITIES_BY_ID`
>
> Get Communities by ID
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **community.fields** `string`
>
> A comma separated list of Community fields to display.

> [accordion] Get lists by
>
> **Slug:** `X_MCP_GET_LISTS_BY_ID`
>
> Get Lists by ID
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **list.fields** `string`
>
> A comma separated list of List fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get lists followers
>
> **Slug:** `X_MCP_GET_LISTS_FOLLOWERS`
>
> Get Lists Followers
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A 64-bit signed integer.

> [accordion] Get lists members
>
> **Slug:** `X_MCP_GET_LISTS_MEMBERS`
>
> Get Lists Members
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A 64-bit signed integer.

> [accordion] Get lists posts
>
> **Slug:** `X_MCP_GET_LISTS_POSTS`
>
> Get Lists Posts
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get news
>
> **Slug:** `X_MCP_GET_NEWS`
>
> Get news stories by ID Each returned story includes a `url` deeplinking to its x.com page.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **news.fields** `string`
>
> A comma separated list of News fields to display.

> [accordion] Get posts by
>
> **Slug:** `X_MCP_GET_POSTS_BY_ID`
>
> Get Posts by ID Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.

> [accordion] Get posts by ids
>
> **Slug:** `X_MCP_GET_POSTS_BY_IDS`
>
> Get Posts by IDs Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> (comma-separated)
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.

> [accordion] Get posts counts recent
>
> **Slug:** `X_MCP_GET_POSTS_COUNTS_RECENT`
>
> Get Posts Counts Recent
>
> #### Input Parameters
>
> **query** `string` *required*
>
> **end\_time** `string`
>
> **since\_id** `string`
>
> **until\_id** `string`
>
> **next\_token** `string`
>
> A base32hex-encoded pagination token.
>
> **start\_time** `string`
>
> Must be within the last 7 days.
>
> **granularity** `string ("minute" | "hour" | "day")`
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.
>
> **search\_count.fields** `string`

> [accordion] Get posts liking users
>
> **Slug:** `X_MCP_GET_POSTS_LIKING_USERS`
>
> Get Posts Liking Users
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get posts quoted posts
>
> **Slug:** `X_MCP_GET_POSTS_QUOTED_POSTS`
>
> Get Posts Quoted Posts Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **exclude** `string`
>
> (comma-separated)
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get posts reposted by
>
> **Slug:** `X_MCP_GET_POSTS_REPOSTED_BY`
>
> Get Posts Reposted by
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get scheduled broadcast
>
> **Slug:** `X_MCP_GET_SCHEDULED_BROADCAST`
>
> Get a scheduled broadcast
>
> #### Input Parameters
>
> **id** `string` *required*

> [accordion] Get scheduled call
>
> **Slug:** `X_MCP_GET_SCHEDULED_CALL`
>
> Get a scheduled call
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **call.fields** `string`
>
> A comma separated list of Call fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **scheduled\_call.fields** `string`
>
> A comma separated list of ScheduledCall fields to display.

> [accordion] Get source
>
> **Slug:** `X_MCP_GET_SOURCE`
>
> Get a stream source
>
> #### Input Parameters
>
> **id** `string` *required*

> [accordion] Get spaces by creator ids
>
> **Slug:** `X_MCP_GET_SPACES_BY_CREATOR_IDS`
>
> Get Spaces by Creator IDs
>
> #### Input Parameters
>
> **user\_ids** `string` *required*
>
> (comma-separated)
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **space.fields** `string`
>
> A comma separated list of Space fields to display.
>
> **topic.fields** `string`
>
> A comma separated list of Topic fields to display.

> [accordion] Get spaces by
>
> **Slug:** `X_MCP_GET_SPACES_BY_ID`
>
> Get Spaces by ID
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **space.fields** `string`
>
> A comma separated list of Space fields to display.
>
> **topic.fields** `string`
>
> A comma separated list of Topic fields to display.

> [accordion] Get spaces by ids
>
> **Slug:** `X_MCP_GET_SPACES_BY_IDS`
>
> Get Spaces by IDs
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> (comma-separated)
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **space.fields** `string`
>
> A comma separated list of Space fields to display.
>
> **topic.fields** `string`
>
> A comma separated list of Topic fields to display.

> [accordion] Get spaces posts
>
> **Slug:** `X_MCP_GET_SPACES_POSTS`
>
> Get Space Posts
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get trends by woeid
>
> **Slug:** `X_MCP_GET_TRENDS_BY_WOEID`
>
> Get Trends by Woeid Each returned trend includes a `url` deeplinking to its x.com search.
>
> #### Input Parameters
>
> **woeid** `integer` *required*
>
> **max\_trends** `integer`
>
> **trend.fields** `string`
>
> A comma separated list of Trend fields to display.

> [accordion] Get usage credits
>
> **Slug:** `X_MCP_GET_USAGE_CREDITS`
>
> Get usage credits

> [accordion] Get users bookmark folders
>
> **Slug:** `X_MCP_GET_USERS_BOOKMARK_FOLDERS`
>
> Get Users Bookmark Folders
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **max\_results** `integer`
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users bookmarks
>
> **Slug:** `X_MCP_GET_USERS_BOOKMARKS`
>
> Get Users Bookmarks Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users bookmarks by folder
>
> **Slug:** `X_MCP_GET_USERS_BOOKMARKS_BY_FOLDER_ID`
>
> Get Users Bookmarks by Folder ID Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **folder\_id** `string` *required*
>
> **max\_results** `integer`
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users by
>
> **Slug:** `X_MCP_GET_USERS_BY_ID`
>
> Get Users by ID
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get users by username
>
> **Slug:** `X_MCP_GET_USERS_BY_USERNAME`
>
> Get Users by Username
>
> #### Input Parameters
>
> **username** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get users by usernames
>
> **Slug:** `X_MCP_GET_USERS_BY_USERNAMES`
>
> Get Users by Usernames
>
> #### Input Parameters
>
> **usernames** `string` *required*
>
> (comma-separated)
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get users followed lists
>
> **Slug:** `X_MCP_GET_USERS_FOLLOWED_LISTS`
>
> Get Users Followed Lists
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **list.fields** `string`
>
> A comma separated list of List fields to display.
>
> **max\_results** `integer`
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A 64-bit signed integer.

> [accordion] Get users liked posts
>
> **Slug:** `X_MCP_GET_USERS_LIKED_POSTS`
>
> Get Users Liked Posts Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users list memberships
>
> **Slug:** `X_MCP_GET_USERS_LIST_MEMBERSHIPS`
>
> Get Users List Memberships
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **list.fields** `string`
>
> A comma separated list of List fields to display.
>
> **max\_results** `integer`
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`

> [accordion] Get users me
>
> **Slug:** `X_MCP_GET_USERS_ME`
>
> Get Users Me
>
> #### Input Parameters
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get users me followers
>
> **Slug:** `X_MCP_GET_USERS_ME_FOLLOWERS`
>
> Get the authenticated user's followers
>
> #### Input Parameters
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users me following
>
> **Slug:** `X_MCP_GET_USERS_ME_FOLLOWING`
>
> Get the users the authenticated user follows
>
> #### Input Parameters
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users mentions
>
> **Slug:** `X_MCP_GET_USERS_MENTIONS`
>
> Get Users Mentions Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **end\_time** `string`
>
> Must be on or after 2010-11-06.
>
> **since\_id** `string`
>
> **until\_id** `string`
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **start\_time** `string`
>
> Must be on or after 2010-11-06.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users owned lists
>
> **Slug:** `X_MCP_GET_USERS_OWNED_LISTS`
>
> Get Users Owned Lists
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **list.fields** `string`
>
> A comma separated list of List fields to display.
>
> **max\_results** `integer`
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **pagination\_token** `string`
>
> A 64-bit signed integer.

> [accordion] Get users pinned lists
>
> **Slug:** `X_MCP_GET_USERS_PINNED_LISTS`
>
> Get Users Pinned Lists
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **list.fields** `string`
>
> A comma separated list of List fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Get users posts
>
> **Slug:** `X_MCP_GET_USERS_POSTS`
>
> Get Users Posts Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **exclude** `string`
>
> (comma-separated)
>
> **end\_time** `string`
>
> Must be on or after 2010-11-06.
>
> **since\_id** `string`
>
> **until\_id** `string`
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **start\_time** `string`
>
> Must be on or after 2010-11-06.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Get users public key
>
> **Slug:** `X_MCP_GET_USERS_PUBLIC_KEY`
>
> Get public keys
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **public\_key.fields** `string`
>
> A comma separated list of PublicKey fields to display.

> [accordion] Get users public keys
>
> **Slug:** `X_MCP_GET_USERS_PUBLIC_KEYS`
>
> Get public keys
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> (comma-separated)
>
> **public\_key.fields** `string`
>
> A comma separated list of PublicKey fields to display.

> [accordion] Get users timeline
>
> **Slug:** `X_MCP_GET_USERS_TIMELINE`
>
> Get Users Timeline Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **exclude** `string`
>
> (comma-separated)
>
> **end\_time** `string`
>
> Must be on or after 2010-11-06.
>
> **since\_id** `string`
>
> **until\_id** `string`
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **start\_time** `string`
>
> Must be on or after 2010-11-06.
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Go live scheduled broadcast
>
> **Slug:** `X_MCP_GO_LIVE_SCHEDULED_BROADCAST`
>
> Go live on a scheduled broadcast
>
> #### Input Parameters
>
> **id** `string` *required*

> [accordion] List broadcasts
>
> **Slug:** `X_MCP_LIST_BROADCASTS`
>
> List broadcasts
>
> #### Input Parameters
>
> **ids** `string`
>
> Comma-separated broadcast IDs to retrieve instead of listing broadcasts.
>
> **max\_results** `integer`
>
> **broadcast.fields** `string`
>
> A comma separated list of Broadcast fields to display.
>
> **pagination\_token** `string`

> [accordion] List scheduled broadcasts
>
> **Slug:** `X_MCP_LIST_SCHEDULED_BROADCASTS`
>
> List scheduled broadcasts
>
> #### Input Parameters
>
> **max\_results** `integer`
>
> **pagination\_token** `string`
>
> **newest\_start\_time** `string`
>
> **oldest\_start\_time** `string`

> [accordion] List scheduled calls
>
> **Slug:** `X_MCP_LIST_SCHEDULED_CALLS`
>
> List scheduled calls
>
> #### Input Parameters
>
> **end\_time** `string`
>
> Calls starting before this time (RFC 3339). Defaults to 24 hours after start\_time.
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **start\_time** `string`
>
> Calls still running at this time or starting after it (RFC 3339). Defaults to now.
>
> **call.fields** `string`
>
> A comma separated list of Call fields to display.
>
> **max\_results** `integer`
>
> The most calls to return. Defaults to 20.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **scheduled\_call.fields** `string`
>
> A comma separated list of ScheduledCall fields to display.

> [accordion] List sources
>
> **Slug:** `X_MCP_LIST_SOURCES`
>
> List stream sources

> [accordion] Mark chat conversation read
>
> **Slug:** `X_MCP_MARK_CHAT_CONVERSATION_READ`
>
> Mark Conversation as Read
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **action\_signatures** `array`
>
> Signature over the read receipt (a MarkConversationReadEvent). Omit to send it unsigned.

> [accordion] Mark chat conversation unread
>
> **Slug:** `X_MCP_MARK_CHAT_CONVERSATION_UNREAD`
>
> Mark Conversation as Unread
>
> #### Input Parameters
>
> **id** `string` *required*

> [accordion] Mute broadcast chat user
>
> **Slug:** `X_MCP_MUTE_BROADCAST_CHAT_USER`
>
> Mute or time out a user in a broadcast chat
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **user\_id** `string` *required*
>
> The user to mute.
>
> **end\_at\_ms** `string`
>
> The Unix timestamp in milliseconds when the mute expires. Omit this field to mute indefinitely.
>
> **message\_id** `string`
>
> A chat message to remove while muting the user.

> [accordion] Pin list
>
> **Slug:** `X_MCP_PIN_LIST`
>
> Pin List
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **list\_id** `string` *required*

> [accordion] Remove chat moderator
>
> **Slug:** `X_MCP_REMOVE_CHAT_MODERATOR`
>
> Remove a chat moderator
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> A 64-bit signed integer.

> [accordion] Remove lists member by user
>
> **Slug:** `X_MCP_REMOVE_LISTS_MEMBER_BY_USER_ID`
>
> Remove a List member
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **user\_id** `string` *required*

> [accordion] Respond to scheduled call
>
> **Slug:** `X_MCP_RESPOND_TO_SCHEDULED_CALL`
>
> Respond to a scheduled call
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **scope** `string ("all" | "this" | "this_and_following")`
>
> Which occurrences of a recurring call: all (the default without occurrence\_start\_time), this (the...
>
> **response** `string ("accepted" | "declined" | "tentative")` *required*
>
> The answer to the invitation.
>
> **occurrence\_start\_time** `string`
>
> Start of the occurrence that scope this or this\_and\_following refers to (RFC 3339).

> [accordion] Schedule call
>
> **Slug:** `X_MCP_SCHEDULE_CALL`
>
> Schedule a call
>
> #### Input Parameters
>
> **title** `string`
>
> Title invitees see.
>
> **time\_zone** `string`
>
> IANA time zone the recurrence follows, such as America/Los\_Angeles.
>
> **recurrence** `string`
>
> RFC 5545 RRULE to repeat the call by, such as FREQ=WEEKLY;BYDAY=MO; the RRULE: prefix is optional.
>
> **start\_time** `string` *required*
>
> When the call starts (RFC 3339); not in the past.
>
> **description** `string`
>
> What the call is about.
>
> **invitee\_ids** `array`
>
> X user ids of the people to invite.
>
> **notify\_invitees** `boolean`
>
> Whether invitees get an email about the call. Defaults to true.
>
> **duration\_minutes** `integer`
>
> How long the call lasts, in minutes. Defaults to 30; at most 31 days.

> [accordion] Search communities
>
> **Slug:** `X_MCP_SEARCH_COMMUNITIES`
>
> Search Communities
>
> #### Input Parameters
>
> **query** `string` *required*
>
> **next\_token** `string`
>
> **max\_results** `integer`
>
> **community.fields** `string`
>
> A comma separated list of Community fields to display.
>
> **pagination\_token** `string`

> [accordion] Search news
>
> **Slug:** `X_MCP_SEARCH_NEWS`
>
> Search News Each returned story includes a `url` deeplinking to its x.com page.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> **max\_results** `integer`
>
> **news.fields** `string`
>
> A comma separated list of News fields to display.
>
> **max\_age\_hours** `integer`

> [accordion] Search posts all
>
> **Slug:** `X_MCP_SEARCH_POSTS_ALL`
>
> Search Posts All Each returned post includes a `url` deeplinking to it on x.com.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> **end\_time** `string`
>
> **since\_id** `string`
>
> **until\_id** `string`
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **next\_token** `string`
>
> A base32hex-encoded pagination token.
>
> **sort\_order** `string ("recency" | "relevancy")`
>
> **start\_time** `string`
>
> **max\_results** `integer`
>
> **poll.fields** `string`
>
> A comma separated list of Poll fields to display.
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **media.fields** `string`
>
> A comma separated list of Media fields to display.
>
> **place.fields** `string`
>
> A comma separated list of Place fields to display.
>
> **pagination\_token** `string`
>
> A base32hex-encoded pagination token.

> [accordion] Search spaces
>
> **Slug:** `X_MCP_SEARCH_SPACES`
>
> Search Spaces
>
> #### Input Parameters
>
> **query** `string` *required*
>
> **state** `string ("live" | "scheduled" | "all")`
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **max\_results** `integer`
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.
>
> **space.fields** `string`
>
> A comma separated list of Space fields to display.
>
> **topic.fields** `string`
>
> A comma separated list of Topic fields to display.

> [accordion] Search users
>
> **Slug:** `X_MCP_SEARCH_USERS`
>
> Search Users
>
> #### Input Parameters
>
> **query** `string` *required*
>
> **expansions** `string`
>
> A comma separated list of fields to expand.
>
> **next\_token** `string`
>
> **max\_results** `integer`
>
> **post.fields** `string`
>
> A comma separated list of Post fields to display.
>
> **user.fields** `string`
>
> A comma separated list of User fields to display.

> [accordion] Send chat message
>
> **Slug:** `X_MCP_SEND_CHAT_MESSAGE`
>
> Send Chat Message
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **message\_id** `string` *required*
>
> Unique identifier for this message.
>
> **xdk\_version** `string`
>
> Version of the Chat XDK that produced the payload.
>
> **conversation\_token** `string`
>
> Optional conversation token.
>
> **encoded\_message\_create\_event** `string` *required*
>
> Base64-encoded Thrift MessageCreateEvent containing encrypted message contents.
>
> **encoded\_message\_event\_signature** `string`
>
> Base64-encoded Thrift MessageEventSignature for message verification.

> [accordion] Send chat typing indicator
>
> **Slug:** `X_MCP_SEND_CHAT_TYPING_INDICATOR`
>
> Send Typing Indicator
>
> #### Input Parameters
>
> **id** `string` *required*

> [accordion] Unarchive chat conversation
>
> **Slug:** `X_MCP_UNARCHIVE_CHAT_CONVERSATION`
>
> Unarchive a Chat conversation
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the conversation: a group ID starting with `g`, the other user's ID for a 1:1 conversat...

> [accordion] Unfollow list
>
> **Slug:** `X_MCP_UNFOLLOW_LIST`
>
> Unfollow a List
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **list\_id** `string` *required*

> [accordion] Unmute broadcast chat user
>
> **Slug:** `X_MCP_UNMUTE_BROADCAST_CHAT_USER`
>
> Unmute a user in a broadcast chat
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **user\_id** `string` *required*
>
> A 64-bit signed integer.

> [accordion] Unpin list
>
> **Slug:** `X_MCP_UNPIN_LIST`
>
> Unpin a List
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **list\_id** `string` *required*

> [accordion] Update lists
>
> **Slug:** `X_MCP_UPDATE_LISTS`
>
> Update List
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **name** `string`
>
> New name for the List (1-25 characters).
>
> **private** `boolean`
>
> Whether the List is private.
>
> **description** `string`
>
> New description for the List (up to 100 characters).

> [accordion] Update scheduled broadcast
>
> **Slug:** `X_MCP_UPDATE_SCHEDULED_BROADCAST`
>
> Update a scheduled broadcast
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **title** `string`
>
> Title / status text.
>
> **locale** `string`
>
> Locale.
>
> **is\_locked** `boolean`
>
> Lock the broadcast.
>
> **source\_id** `string`
>
> Ingest / source id.
>
> **chat\_option** `string`
>
> Who can chat (numeric string): `0` default, `1` chat off, `2` everyone, `3` verified accounts, \`4...
>
> **description** `string`
>
> Description.
>
> **roll\_forward** `boolean`
>
> Deprecated: recurring schedules are being retired and `true` will be rejected.
>
> **manual\_publish** `boolean`
>
> If true, do not auto-publish at start; call POST .../live when ready.
>
> **scheduled\_end\_ms** `string` *required*
>
> End time, ms since Unix epoch (decimal string).
>
> **scheduled\_start\_ms** `string` *required*
>
> Start time, ms since Unix epoch (decimal string).
>
> **thumbnail\_media\_id** `string`
>
> Pre-live slate media id (numeric string).
>
> **available\_for\_replay** `boolean`
>
> Enable replay.
>
> **scheduled\_broadcast\_id** `string` *required*
>
> Numeric scheduler id from create/list/get.

> [accordion] Update scheduled call
>
> **Slug:** `X_MCP_UPDATE_SCHEDULED_CALL`
>
> Update a scheduled call
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **scope** `string ("all" | "this" | "this_and_following")`
>
> Which occurrences of a recurring call: all (the default without occurrence\_start\_time), this (the...
>
> **title** `string`
>
> Title invitees see.
>
> **time\_zone** `string`
>
> IANA time zone the recurrence follows.
>
> **recurrence** `string`
>
> RFC 5545 RRULE to repeat the call by, such as FREQ=WEEKLY;BYDAY=MO.
>
> **start\_time** `string`
>
> When the call (or the chosen occurrence) starts now (RFC 3339).
>
> **description** `string`
>
> What the call is about.
>
> **invitee\_ids** `array`
>
> Everyone to invite: replaces the invite list. At most 25 of them may be people not invited yet.
>
> **notify\_invitees** `boolean`
>
> Whether invitees get an email about the change. Defaults to true.
>
> **duration\_minutes** `integer`
>
> How long the call lasts, in minutes.
>
> **occurrence\_start\_time** `string`
>
> Start of the occurrence that scope this or this\_and\_following refers to (RFC 3339).

> [accordion] Update source
>
> **Slug:** `X_MCP_UPDATE_SOURCE`
>
> Rename a stream source
>
> #### Input Parameters
>
> **id** `string` *required*
>
> **name** `string` *required*
>
> New label for the source.
