Focus · X
Typed Focus mode operations for X accounts, generated from the X focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
- Bookmarks1
- Following10
- Posts12
- Threads2
- Polls3
- Articles2
- Media7
- Replies10
- Mentions7
- Quotes6
- Reposts of me1
- Liking users1
- Reposted by1
- Liked posts3
- Bookmark folders2
- Home timeline6
- Profile1
- Followers10
- Users11
- Affiliates1
- Mutes3
- Blocks3
- Lists11
- List members3
- List followers1
- List posts1
- Followed lists3
- Pinned lists3
- List memberships1
- Conversations5
- DM events4
- Chat conversations9
- Post counts1
- Trends1
- News2
- Communities3
- Spaces2
- Space posts1
- Space buyers1
- Broadcasts2
- Scheduled broadcasts6
- Broadcast chat6
- Broadcast moderators3
- Account overview1
- Post metrics1
- Post analytics1
- Media analytics1
- Usage1
Bookmarks
X: List Bookmarks
/accounts/{accountId}/x/bookmarksGET /2/users/:id/bookmarks (or a folder). Your bookmarks, optionally inside a folder: a curation library for reposts and inspiration. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, bookmark.read. Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call x-bookmarks-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
folder_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Following
X: List Following
/accounts/{accountId}/x/followingGET /2/users/:id/following. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Cursor pagination: pass next_cursor back as cursor. Requires scopes: follows.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–1000
user_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Follow (Following)
/accounts/{accountId}/x/following/{itemId}/followEnterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-follow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unfollow (Following)
/accounts/{accountId}/x/following/{itemId}/unfollowEnterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-unfollow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Mute (Following)
/accounts/{accountId}/x/following/{itemId}/muteMute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-mute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unmute (Following)
/accounts/{accountId}/x/following/{itemId}/unmuteUnmute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-unmute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block (Following)
/accounts/{accountId}/x/following/{itemId}/blockEnterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-block (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unblock (Following)
/accounts/{accountId}/x/following/{itemId}/unblockEnterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-unblock (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block DMs (Following)
/accounts/{accountId}/x/following/{itemId}/block-dmsBlock DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-block-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unblock DMs (Following)
/accounts/{accountId}/x/following/{itemId}/unblock-dmsUnblock DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-unblock-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Send DM (Following)
/accounts/{accountId}/x/following/{itemId}/send-dmSend DM. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call x-following-send-dm (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 10000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Posts
X: List Posts
/accounts/{accountId}/x/postsYour timeline (GET /2/users/:id/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
excludestringrepliesretweetsreplies,retweets
start_timestring (date-time)end_timestring (date-time)since_idstringuntil_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Posts item
/accounts/{accountId}/x/postsPublish a post (POST /2/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredmediaarray of string | objectUp to 4 images, or 1 GIF, or 1 video
≤ 4 items
One of 2 shapes
Option 1 string
Option 2 object
mediastringalt_textstring≤ 1000 characters
reply_settingsstringfollowingmentionedUserssubscribersverified
reply_to_post_idstringReply to this post (id or URL)
quote_post_idstringQuote this post (Enterprise-only)
community_idstringfor_super_followers_onlybooleanpaid_partnershipbooleanmade_with_aibooleansensitive_mediaobjectShow 3 child attributes
adult_contentbooleangraphic_violencebooleanotherbooleangeo_countriesarray of string≤ 25 items
place_idstringtagged_user_idsarray of string≤ 10 items
long_videobooleanfirst_commentstringauto_threadbooleanSplit long text into a thread
Returns object
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyResponses
X: Get a Posts item
/accounts/{accountId}/x/posts/{itemId}Post lookup (GET /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyResponses
X: Update a Posts item
/accounts/{accountId}/x/posts/{itemId}Edit a post (X Premium; returns a new post id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-update (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequiredmediaarray of string≤ 4 items
Returns object
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyResponses
X: Delete a Posts item
/accounts/{accountId}/x/posts/{itemId}Delete a post (DELETE /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
X: Reply (Posts)
/accounts/{accountId}/x/posts/{itemId}/replyReply. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-reply (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 25000 characters
mediaarray of string≤ 4 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Repost (Posts)
/accounts/{accountId}/x/posts/{itemId}/repostRepost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-repost (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Undo repost (Posts)
/accounts/{accountId}/x/posts/{itemId}/undo-repostUndo repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-undo-repost (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Like (Posts)
/accounts/{accountId}/x/posts/{itemId}/likeEnterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-like (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unlike (Posts)
/accounts/{accountId}/x/posts/{itemId}/unlikeEnterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-unlike (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Bookmark (Posts)
/accounts/{accountId}/x/posts/{itemId}/bookmarkBookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-bookmark (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
folder_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Remove bookmark (Posts)
/accounts/{accountId}/x/posts/{itemId}/remove-bookmarkRemove bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call x-posts-remove-bookmark (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads
X: Get a Threads item
/accounts/{accountId}/x/threads/{itemId}Your posts in the conversation rooted at :id (recent search). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/threads.
Try it with MCPAsk your agent to call x-threads-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlyurlstring (uri)read-onlyitemsarray of objectShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlythread_idsarray of stringResponses
X: Create a Threads item
/accounts/{accountId}/x/threadsPublish a thread (chained POST /2/tweets). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/threads.
Try it with MCPAsk your agent to call x-threads-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
itemsarray of objectrequired≥ 1 items
Show 2 item attributes
textstringrequiredmediaarray of string≤ 4 items
reply_settingsstringfollowingmentionedUserssubscribersverified
first_commentstringReturns object
idstringread-onlyurlstring (uri)read-onlyitemsarray of objectShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlythread_idsarray of stringResponses
Polls
X: List Polls
/accounts/{accountId}/x/pollsYour recent posts that carry a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call x-polls-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringread-onlytextstringcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobjectShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Polls item
/accounts/{accountId}/x/pollsPublish a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call x-polls-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredoptionsarray of stringrequired2–4 items
duration_minutesintegerrequireddefault: 14405–10080
reply_settingsstringfollowingmentionedUserssubscribersverified
Returns object
idstringread-onlytextstringcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobjectShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyResponses
X: Get a Polls item
/accounts/{accountId}/x/polls/{itemId}Poll results for a post. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call x-polls-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytextstringcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobjectShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyResponses
Articles
X: Create a Articles item
/accounts/{accountId}/x/articlesCreate an Article draft and optionally publish it. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: /v1/accounts/{accountId}/focus/articles.
Try it with MCPAsk your agent to call x-articles-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequired≥ 1 characters
textstringBody; "# ", "## ", "> ", "- ", "1. " prefixes become headings, quotes and lists
content_stateobjectDraftJS content_state (snake_case); overrides text
Show 2 child attributes
blocksarray of objectentitiesarray of objectmodestringdefault: "publish"publishdraft
coverstringCover image (JPG, PNG or WebP)
cover_alt_textstring≤ 1000 characters
Returns object
idstringread-onlyarticle_idstringread-onlytitlestringmodestringpublishdraft
urlstring (uri) | nullread-onlyResponses
X: Publish draft (Articles)
/accounts/{accountId}/x/articles/{itemId}/publishPOST /2/articles/:id/publish. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: /v1/accounts/{accountId}/focus/articles.
Try it with MCPAsk your agent to call x-articles-publish (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Media
X: List Media
/accounts/{accountId}/x/mediaLook up media by key (GET /2/media). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
media_keysstringrequiredComma-separated media keys
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
media_keystringread-onlymedia_idstring | nullread-onlytypestringread-onlyurlstring (uri) | nullread-onlypreview_image_urlstring (uri) | nullread-onlywidthinteger | nullheightinteger | nullduration_msinteger | nullalt_textstring | null≤ 1000 characters
view_countinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Media item
/accounts/{accountId}/x/mediaUpload media (simple for images, chunked for GIF/video). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredcategorystringdefault: "tweet_image"tweet_imagetweet_giftweet_videoamplify_videodm_imagedm_gifdm_video
alt_textstring≤ 1000 characters
Returns object
media_keystringread-onlymedia_idstring | nullread-onlytypestringread-onlyurlstring (uri) | nullread-onlypreview_image_urlstring (uri) | nullread-onlywidthinteger | nullheightinteger | nullduration_msinteger | nullalt_textstring | null≤ 1000 characters
view_countinteger | nullResponses
X: Get a Media item
/accounts/{accountId}/x/media/{itemId}GET /2/media/:media_key. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
media_keystringread-onlymedia_idstring | nullread-onlytypestringread-onlyurlstring (uri) | nullread-onlypreview_image_urlstring (uri) | nullread-onlywidthinteger | nullheightinteger | nullduration_msinteger | nullalt_textstring | null≤ 1000 characters
view_countinteger | nullResponses
X: Alt text and flags (Media)
/accounts/{accountId}/x/media/{itemId}/set-metadataAlt text and flags. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-set-metadata (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
alt_textstring≤ 1000 characters
sensitive_mediaobjectShow 3 child attributes
adult_contentbooleangraphic_violencebooleanotherbooleangeo_countriesarray of stringallow_downloadbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Add subtitles (Media)
/accounts/{accountId}/x/media/{itemId}/add-subtitlesAdd subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-add-subtitles (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
filestringrequiredSRT or VTT file
languagestringrequired≥ 2 characters
display_namestringamplifybooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Delete subtitles (Media)
/accounts/{accountId}/x/media/{itemId}/delete-subtitlesDelete subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Destructive. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-delete-subtitles (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
languagestringrequired≥ 2 characters
amplifybooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Processing status (Media)
/accounts/{accountId}/x/media/{itemId}/statusProcessing status. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call x-media-status (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Replies
X: List Replies
/accounts/{accountId}/x/repliesReplies to one post (post_id) or to all your recent posts. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
post_idstringRoot post id or URL
archivebooleanFull-archive search (older than 7 days)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 32 item attributes
idstringread-onlytextstringcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyauthorstringread-onlyparent_idstring | nullread-onlyhiddenboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Replies item
/accounts/{accountId}/x/repliesReply to a post or reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reply_to_idstringrequiredtextstringrequiredmediaarray of string≤ 4 items
Returns object
idstringread-onlytextstringcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyauthorstringread-onlyparent_idstring | nullread-onlyhiddenboolean | nullResponses
X: Delete a Replies item
/accounts/{accountId}/x/replies/{itemId}Delete one of your replies. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
X: Reply (Replies)
/accounts/{accountId}/x/replies/{itemId}/replyReply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-reply (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredmediaarray of string≤ 4 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Like (Replies)
/accounts/{accountId}/x/replies/{itemId}/likeEnterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-like (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unlike (Replies)
/accounts/{accountId}/x/replies/{itemId}/unlikeEnterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-unlike (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Repost (Replies)
/accounts/{accountId}/x/replies/{itemId}/repostRepost. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-repost (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Bookmark (Replies)
/accounts/{accountId}/x/replies/{itemId}/bookmarkBookmark. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-bookmark (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Hide reply (Replies)
/accounts/{accountId}/x/replies/{itemId}/hideHide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-hide (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unhide reply (Replies)
/accounts/{accountId}/x/replies/{itemId}/unhideUnhide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call x-replies-unhide (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mentions
X: List Mentions
/accounts/{accountId}/x/mentionsGET /2/users/:id/mentions. Posts that mention you. Replying is allowed on self-serve because you were summoned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
since_idstringstart_timestring (date-time)end_timestring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 32 item attributes
idstringread-onlytextstringcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyauthorstringread-onlyparent_idstring | nullread-onlyhiddenboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Reply (Mentions)
/accounts/{accountId}/x/mentions/{itemId}/replyReply. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-reply (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredmediaarray of string≤ 4 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Like (Mentions)
/accounts/{accountId}/x/mentions/{itemId}/likeEnterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-like (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unlike (Mentions)
/accounts/{accountId}/x/mentions/{itemId}/unlikeEnterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-unlike (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Repost (Mentions)
/accounts/{accountId}/x/mentions/{itemId}/repostRepost. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-repost (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Bookmark (Mentions)
/accounts/{accountId}/x/mentions/{itemId}/bookmarkBookmark. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-bookmark (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Hide reply (Mentions)
/accounts/{accountId}/x/mentions/{itemId}/hideOnly for replies in your conversations. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call x-mentions-hide (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Quotes
X: List Quotes
/accounts/{accountId}/x/quotesGET /2/tweets/:id/quote_tweets. Quote posts of one of your posts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/quotes.
Try it with MCPAsk your agent to call x-quotes-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
post_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Reply (Quotes)
/accounts/{accountId}/x/quotes/{itemId}/replyReply. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/quotes.
Try it with MCPAsk your agent to call x-quotes-reply (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredmediaarray of string≤ 4 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Like (Quotes)
/accounts/{accountId}/x/quotes/{itemId}/likeEnterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/quotes.
Try it with MCPAsk your agent to call x-quotes-like (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unlike (Quotes)
/accounts/{accountId}/x/quotes/{itemId}/unlikeEnterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/quotes.
Try it with MCPAsk your agent to call x-quotes-unlike (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Repost (Quotes)
/accounts/{accountId}/x/quotes/{itemId}/repostRepost. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/quotes.
Try it with MCPAsk your agent to call x-quotes-repost (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Bookmark (Quotes)
/accounts/{accountId}/x/quotes/{itemId}/bookmarkBookmark. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/quotes.
Try it with MCPAsk your agent to call x-quotes-bookmark (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reposts of me
X: List Reposts of me
/accounts/{accountId}/x/reposts-of-meGET /2/users/reposts_of_me. Your posts that other accounts reposted. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, timeline.read. Generic route: /v1/accounts/{accountId}/focus/reposts-of-me.
Try it with MCPAsk your agent to call x-reposts-of-me-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Liking users
X: List Liked by
/accounts/{accountId}/x/liking-usersGET /2/tweets/:id/liking_users. Accounts that liked a post. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, like.read. Generic route: /v1/accounts/{accountId}/focus/liking-users.
Try it with MCPAsk your agent to call x-liking-users-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
post_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reposted by
X: List Reposted by
/accounts/{accountId}/x/reposted-byGET /2/tweets/:id/retweeted_by. Accounts that reposted a post. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/reposted-by.
Try it with MCPAsk your agent to call x-reposted-by-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
post_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Liked posts
X: List Likes
/accounts/{accountId}/x/liked-postsGET /2/users/:id/liked_tweets. Posts you liked. Liking and unliking are Enterprise-only on X. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, like.read. Generic route: /v1/accounts/{accountId}/focus/liked-posts.
Try it with MCPAsk your agent to call x-liked-posts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Likes item
/accounts/{accountId}/x/liked-postsLike a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: /v1/accounts/{accountId}/focus/liked-posts.
Try it with MCPAsk your agent to call x-liked-posts-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
post_idstringrequiredReturns object
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlyResponses
X: Delete a Likes item
/accounts/{accountId}/x/liked-posts/{itemId}Unlike a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: /v1/accounts/{accountId}/focus/liked-posts.
Try it with MCPAsk your agent to call x-liked-posts-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Bookmark folders
X: List Bookmark folders
/accounts/{accountId}/x/bookmark-foldersGET /2/users/:id/bookmarks/folders. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, bookmark.read. Generic route: /v1/accounts/{accountId}/focus/bookmark-folders.
Try it with MCPAsk your agent to call x-bookmark-folders-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringread-onlynamestringrequired1–25 characters
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Bookmark folders item
/accounts/{accountId}/x/bookmark-foldersPOST /2/users/:id/bookmarks/folders. Requires scopes: users.read, bookmark.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/bookmark-folders.
Try it with MCPAsk your agent to call x-bookmark-folders-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–25 characters
Returns object
idstringread-onlynamestringrequired1–25 characters
Responses
Home timeline
X: List Home timeline
/accounts/{accountId}/x/home-timelineGET /2/users/:id/timelines/reverse_chronological. Posts from accounts you follow, newest first. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call x-home-timeline-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
excludestringrepliesretweetsreplies,retweets
start_timestring (date-time)end_timestring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Reply (Home timeline)
/accounts/{accountId}/x/home-timeline/{itemId}/replyReply. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call x-home-timeline-reply (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredmediaarray of string≤ 4 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Like (Home timeline)
/accounts/{accountId}/x/home-timeline/{itemId}/likeEnterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call x-home-timeline-like (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unlike (Home timeline)
/accounts/{accountId}/x/home-timeline/{itemId}/unlikeEnterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call x-home-timeline-unlike (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Repost (Home timeline)
/accounts/{accountId}/x/home-timeline/{itemId}/repostRepost. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call x-home-timeline-repost (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Bookmark (Home timeline)
/accounts/{accountId}/x/home-timeline/{itemId}/bookmarkBookmark. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call x-home-timeline-bookmark (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Profile
X: Get Profile
/accounts/{accountId}/x/profileGET /2/users/me. The connected account: handle, bio, verification and public counts. X has no profile-editing API. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call x-profile-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlyusernamestringread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlyconfirmed_emailstring (email) | nullread-onlyNeeds users.email
subscription_typestring | nullread-onlyverified_followers_countinteger | nullread-onlypinned_post_idstring | nullread-onlyResponses
Followers
X: List Followers
/accounts/{accountId}/x/followersGET /2/users/:id/followers ($0.010 per user returned). Cursor pagination: pass next_cursor back as cursor. Requires scopes: follows.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–1000
user_idstringDefaults to the connected account
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Follow (Followers)
/accounts/{accountId}/x/followers/{itemId}/followEnterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-follow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unfollow (Followers)
/accounts/{accountId}/x/followers/{itemId}/unfollowEnterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-unfollow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Mute (Followers)
/accounts/{accountId}/x/followers/{itemId}/muteMute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-mute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unmute (Followers)
/accounts/{accountId}/x/followers/{itemId}/unmuteUnmute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-unmute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block (Followers)
/accounts/{accountId}/x/followers/{itemId}/blockEnterprise-only on X. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-block (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unblock (Followers)
/accounts/{accountId}/x/followers/{itemId}/unblockEnterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-unblock (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block DMs (Followers)
/accounts/{accountId}/x/followers/{itemId}/block-dmsBlock DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-block-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unblock DMs (Followers)
/accounts/{accountId}/x/followers/{itemId}/unblock-dmsUnblock DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-unblock-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Send DM (Followers)
/accounts/{accountId}/x/followers/{itemId}/send-dmSend DM. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call x-followers-send-dm (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 10000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Users
X: List People
/accounts/{accountId}/x/usersGET /2/users/search. Search and look up X accounts; follow, mute, block or DM them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
qstringrequiredName or handle
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Get a People item
/accounts/{accountId}/x/users/{itemId}GET /2/users/:id or /2/users/by/username/:username. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlyResponses
X: Follow (People)
/accounts/{accountId}/x/users/{itemId}/followEnterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-follow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unfollow (People)
/accounts/{accountId}/x/users/{itemId}/unfollowEnterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-unfollow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Mute (People)
/accounts/{accountId}/x/users/{itemId}/muteMute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-mute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unmute (People)
/accounts/{accountId}/x/users/{itemId}/unmuteUnmute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-unmute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block (People)
/accounts/{accountId}/x/users/{itemId}/blockEnterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Destructive. Requires scopes: users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-block (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unblock (People)
/accounts/{accountId}/x/users/{itemId}/unblockEnterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-unblock (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block DMs (People)
/accounts/{accountId}/x/users/{itemId}/block-dmsBlock DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-block-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unblock DMs (People)
/accounts/{accountId}/x/users/{itemId}/unblock-dmsUnblock DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-unblock-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Send DM (People)
/accounts/{accountId}/x/users/{itemId}/send-dmSend DM. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/users.
Try it with MCPAsk your agent to call x-users-send-dm (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 10000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Affiliates
X: List Affiliates
/accounts/{accountId}/x/affiliatesGET /2/users/:id/affiliates. Accounts affiliated with a verified organization. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/affiliates.
Try it with MCPAsk your agent to call x-affiliates-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
user_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mutes
X: List Muted accounts
/accounts/{accountId}/x/mutesGET /2/users/:id/muting. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mute.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call x-mutes-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–1000
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Muted accounts item
/accounts/{accountId}/x/mutesMute a user. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call x-mutes-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringusernamestringReturns object
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlyResponses
X: Delete a Muted accounts item
/accounts/{accountId}/x/mutes/{itemId}Unmute. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call x-mutes-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Blocks
X: List Blocked accounts
/accounts/{accountId}/x/blocksGET /2/users/:id/blocking. Reading the block list is self-serve; block/unblock are Enterprise-only on X. Cursor pagination: pass next_cursor back as cursor. Requires scopes: block.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call x-blocks-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–1000
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Blocked accounts item
/accounts/{accountId}/x/blocksBlock a user (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call x-blocks-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringusernamestringReturns object
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlyResponses
X: Delete a Blocked accounts item
/accounts/{accountId}/x/blocks/{itemId}Unblock (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call x-blocks-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Lists
X: List My lists
/accounts/{accountId}/x/listsGET /2/users/:id/owned_lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
user_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a My lists item
/accounts/{accountId}/x/listsPOST /2/lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired1–25 characters
descriptionstring≤ 100 characters
privatebooleanReturns object
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlyResponses
X: Get a My lists item
/accounts/{accountId}/x/lists/{itemId}GET /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlyResponses
X: Update a My lists item
/accounts/{accountId}/x/lists/{itemId}PUT /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-update (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestring1–25 characters
descriptionstring≤ 100 characters
privatebooleanReturns object
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlyResponses
X: Delete a My lists item
/accounts/{accountId}/x/lists/{itemId}DELETE /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
X: Add member (My lists)
/accounts/{accountId}/x/lists/{itemId}/add-memberAdd member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-add-member (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringusernamestringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Remove member (My lists)
/accounts/{accountId}/x/lists/{itemId}/remove-memberRemove member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-remove-member (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Follow list (My lists)
/accounts/{accountId}/x/lists/{itemId}/followFollow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-follow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unfollow list (My lists)
/accounts/{accountId}/x/lists/{itemId}/unfollowUnfollow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-unfollow (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Pin (My lists)
/accounts/{accountId}/x/lists/{itemId}/pinPin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-pin (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unpin (My lists)
/accounts/{accountId}/x/lists/{itemId}/unpinUnpin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call x-lists-unpin (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
List members
X: List List members
/accounts/{accountId}/x/list-membersGET /2/lists/:id/members (item id = "<list_id>:<user_id>"). Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call x-list-members-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
list_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
idstringread-onlyusernamestringread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylist_idstringread-onlyuser_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a List members item
/accounts/{accountId}/x/list-membersPOST /2/lists/:id/members. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call x-list-members-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
list_idstringrequireduser_idstringusernamestringReturns object
idstringread-onlyusernamestringread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylist_idstringread-onlyuser_idstringread-onlyResponses
X: Delete a List members item
/accounts/{accountId}/x/list-members/{itemId}DELETE /2/lists/:id/members/:user_id. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call x-list-members-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
List followers
X: List List followers
/accounts/{accountId}/x/list-followersGET /2/lists/:id/followers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-followers.
Try it with MCPAsk your agent to call x-list-followers-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
list_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
List posts
X: List List timeline
/accounts/{accountId}/x/list-postsGET /2/lists/:id/tweets. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-posts.
Try it with MCPAsk your agent to call x-list-posts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
list_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Followed lists
X: List Followed lists
/accounts/{accountId}/x/followed-listsGET /2/users/:id/followed_lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/followed-lists.
Try it with MCPAsk your agent to call x-followed-lists-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Followed lists item
/accounts/{accountId}/x/followed-listsFollow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/followed-lists.
Try it with MCPAsk your agent to call x-followed-lists-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
list_idstringrequiredReturns object
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlyResponses
X: Delete a Followed lists item
/accounts/{accountId}/x/followed-lists/{itemId}Unfollow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/followed-lists.
Try it with MCPAsk your agent to call x-followed-lists-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Pinned lists
X: List Pinned lists
/accounts/{accountId}/x/pinned-listsGET /2/users/:id/pinned_lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.
Try it with MCPAsk your agent to call x-pinned-lists-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Pinned lists item
/accounts/{accountId}/x/pinned-listsPin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.
Try it with MCPAsk your agent to call x-pinned-lists-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
list_idstringrequiredReturns object
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlyResponses
X: Delete a Pinned lists item
/accounts/{accountId}/x/pinned-lists/{itemId}Unpin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.
Try it with MCPAsk your agent to call x-pinned-lists-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
List memberships
X: List Lists I am on
/accounts/{accountId}/x/list-membershipsGET /2/users/:id/list_memberships. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-memberships.
Try it with MCPAsk your agent to call x-list-memberships-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringrequiredread-onlynamestringrequired1–25 characters
descriptionstring | null≤ 100 characters
privatebooleandefault: falsemember_countintegerread-onlyfollower_countintegerread-onlycreated_atstring (date-time)read-onlyowner_idstringread-onlyowner_usernamestring | nullread-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Conversations
X: List Direct messages
/accounts/{accountId}/x/conversationsConversations grouped from GET /2/dm_events. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call x-conversations-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringread-onlytypestringread-onlyone_to_onegroup
participantsarray of objectread-onlyShow 4 item attributes
idstringnamestringusernamestringavatar_urlstring (uri)last_messagestring | nullread-onlylast_sender_idstring | nullread-onlyupdated_atstring (date-time)read-onlyunread_countintegerread-onlymessage_countintegerread-onlymessagesarray of objectread-onlyShow 10 item attributes
idstringread-onlytextstringdirectionstringread-onlyinout
sent_atstring (date-time)read-onlyfrom_idstringread-onlysender_usernamestring | nullread-onlysender_namestring | nullread-onlyconversation_idstringread-onlyevent_typestringread-onlyMessageCreateParticipantsJoinParticipantsLeave
attachmentsarray of objectread-onlyShow 3 item attributes
typestringmedia_keystringurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Direct messages item
/accounts/{accountId}/x/conversationsStart a 1:1 conversation (participant id or @username) or a group (participant_ids). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call x-conversations-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
participant_idstringparticipant_usernamestringparticipant_idsarray of stringGroup conversation
2–49 items
textstring≤ 10000 characters
mediastringskip_dm_checkbooleanReturns object
idstringread-onlytypestringread-onlyone_to_onegroup
participantsarray of objectread-onlyShow 4 item attributes
idstringnamestringusernamestringavatar_urlstring (uri)last_messagestring | nullread-onlylast_sender_idstring | nullread-onlyupdated_atstring (date-time)read-onlyunread_countintegerread-onlymessage_countintegerread-onlymessagesarray of objectread-onlyShow 10 item attributes
idstringread-onlytextstringdirectionstringread-onlyinout
sent_atstring (date-time)read-onlyfrom_idstringread-onlysender_usernamestring | nullread-onlysender_namestring | nullread-onlyconversation_idstringread-onlyevent_typestringread-onlyMessageCreateParticipantsJoinParticipantsLeave
attachmentsarray of objectread-onlyShow 3 item attributes
typestringmedia_keystringurlstring (uri) | nullResponses
X: Get a Direct messages item
/accounts/{accountId}/x/conversations/{itemId}Messages in a conversation (GET /2/dm_conversations/:id/dm_events). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call x-conversations-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytypestringread-onlyone_to_onegroup
participantsarray of objectread-onlyShow 4 item attributes
idstringnamestringusernamestringavatar_urlstring (uri)last_messagestring | nullread-onlylast_sender_idstring | nullread-onlyupdated_atstring (date-time)read-onlyunread_countintegerread-onlymessage_countintegerread-onlymessagesarray of objectread-onlyShow 10 item attributes
idstringread-onlytextstringdirectionstringread-onlyinout
sent_atstring (date-time)read-onlyfrom_idstringread-onlysender_usernamestring | nullread-onlysender_namestring | nullread-onlyconversation_idstringread-onlyevent_typestringread-onlyMessageCreateParticipantsJoinParticipantsLeave
attachmentsarray of objectread-onlyShow 3 item attributes
typestringmedia_keystringurlstring (uri) | nullResponses
X: Send message (Direct messages)
/accounts/{accountId}/x/conversations/{itemId}/sendSend message. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call x-conversations-send (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstring≤ 10000 characters
mediastringOne image, GIF or video
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Block DMs from participant (Direct messages)
/accounts/{accountId}/x/conversations/{itemId}/block-dmsBlock DMs from participant. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call x-conversations-block-dms (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
DM events
X: List DM events
/accounts/{accountId}/x/dm-eventsGET /2/dm_events. Raw DM event log: messages, joins and leaves across conversations. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/dm-events.
Try it with MCPAsk your agent to call x-dm-events-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
event_typesarray of stringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlytextstringdirectionstringread-onlyinout
sent_atstring (date-time)read-onlyfrom_idstringread-onlysender_usernamestring | nullread-onlysender_namestring | nullread-onlyconversation_idstringread-onlyevent_typestringread-onlyMessageCreateParticipantsJoinParticipantsLeave
attachmentsarray of objectread-onlyShow 3 item attributes
typestringmedia_keystringurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a DM events item
/accounts/{accountId}/x/dm-eventsSend a DM to a participant or conversation. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/dm-events.
Try it with MCPAsk your agent to call x-dm-events-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
participant_idstringconversation_idstringtextstring≤ 10000 characters
mediastringReturns object
idstringread-onlytextstringdirectionstringread-onlyinout
sent_atstring (date-time)read-onlyfrom_idstringread-onlysender_usernamestring | nullread-onlysender_namestring | nullread-onlyconversation_idstringread-onlyevent_typestringread-onlyMessageCreateParticipantsJoinParticipantsLeave
attachmentsarray of objectread-onlyShow 3 item attributes
typestringmedia_keystringurlstring (uri) | nullResponses
X: Get a DM events item
/accounts/{accountId}/x/dm-events/{itemId}GET /2/dm_events/:id. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/dm-events.
Try it with MCPAsk your agent to call x-dm-events-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytextstringdirectionstringread-onlyinout
sent_atstring (date-time)read-onlyfrom_idstringread-onlysender_usernamestring | nullread-onlysender_namestring | nullread-onlyconversation_idstringread-onlyevent_typestringread-onlyMessageCreateParticipantsJoinParticipantsLeave
attachmentsarray of objectread-onlyShow 3 item attributes
typestringmedia_keystringurlstring (uri) | nullResponses
X: Delete a DM events item
/accounts/{accountId}/x/dm-events/{itemId}DELETE /2/dm_events/:id (for you only). Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/dm-events.
Try it with MCPAsk your agent to call x-dm-events-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Chat conversations
X: List X Chat
/accounts/{accountId}/x/chat-conversationsGET /2/chat/conversations (or message requests). Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
unread_onlybooleanfolderstringdefault: "inbox"inboxrequests
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlytypestring | nullgroup_namestring | nullEncrypted with the conversation key for groups
participantsarray of objectShow 3 item attributes
idstringusernamestringnamestringunreadboolean | nullis_archivedbooleanis_mutedbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullnewest_event_idstring | nullmessage_ttl_msinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Get a X Chat item
/accounts/{accountId}/x/chat-conversations/{itemId}GET /2/chat/conversations/:id. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytypestring | nullgroup_namestring | nullEncrypted with the conversation key for groups
participantsarray of objectShow 3 item attributes
idstringusernamestringnamestringunreadboolean | nullis_archivedbooleanis_mutedbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullnewest_event_idstring | nullmessage_ttl_msinteger | nullResponses
X: Mark read (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/mark-readMark read. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-mark-read (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Mark unread (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/mark-unreadMark unread. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-mark-unread (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Archive (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/archiveArchive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-archive (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unarchive (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/unarchiveUnarchive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-unarchive (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Mute (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/muteMute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-mute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unmute (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/unmuteUnmute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-unmute (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Accept message request (X Chat)
/accounts/{accountId}/x/chat-conversations/{itemId}/acceptAccept message request. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.
Try it with MCPAsk your agent to call x-chat-conversations-accept (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Post counts
X: List Post volume
/accounts/{accountId}/x/post-countsGET /2/tweets/counts/recent ($0.005 per request). How many posts match a query over the last 7 days (per minute, hour or day). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Generic route: /v1/accounts/{accountId}/focus/post-counts.
Try it with MCPAsk your agent to call x-post-counts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredgranularitystringdefault: "day"minutehourday
start_timestring (date-time)end_timestring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
datestring (date-time)endstring (date-time)postsintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Trends
X: List Trends
/accounts/{accountId}/x/trendsGET /2/users/personalized_trends | /2/trends/by/woeid/:woeid ($0.010 per request). Trends personalized for the account, or for a location (WOEID). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/trends.
Try it with MCPAsk your agent to call x-trends-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
woeidintegerYahoo WOEID (1 = worldwide). Omit for personalized trends.
limitinteger1–50
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringtrend_namestringpost_countstring | nullAs reported by X, e.g. "12.5K posts"
categorystring | nulltrending_sincestring | nullsearch_urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
News
X: List News
/accounts/{accountId}/x/newsGET /2/news/search. X News stories (Grok-summarized clusters of posts). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/news.
Try it with MCPAsk your agent to call x-news-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredmax_age_hoursintegerdefault: 1681–720
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringnamestringsummarystringhookstring | nullcategorystring | nullkeywordsarray of stringupdated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Get a News item
/accounts/{accountId}/x/news/{itemId}GET /2/news/:id. X News stories (Grok-summarized clusters of posts). Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/news.
Try it with MCPAsk your agent to call x-news-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringnamestringsummarystringhookstring | nullcategorystring | nullkeywordsarray of stringupdated_atstring (date-time) | nullResponses
Communities
X: List Communities
/accounts/{accountId}/x/communitiesGET /2/communities/search. Find X Communities and post into them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.
Try it with MCPAsk your agent to call x-communities-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredcursorstringlimitinteger10–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringread-onlynamestringdescriptionstring | nullaccessstring | nulljoin_policystring | nullmember_countinteger | nullcreated_atstring (date-time) | nullurlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Get a Communities item
/accounts/{accountId}/x/communities/{itemId}GET /2/communities/:id. Find X Communities and post into them. Requires scopes: tweet.read, users.read, list.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.
Try it with MCPAsk your agent to call x-communities-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlynamestringdescriptionstring | nullaccessstring | nulljoin_policystring | nullmember_countinteger | nullcreated_atstring (date-time) | nullurlstring (uri)Responses
X: Post to community (Communities)
/accounts/{accountId}/x/communities/{itemId}/postPost to community. Find X Communities and post into them. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.
Try it with MCPAsk your agent to call x-communities-post (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredmediaarray of string≤ 4 items
share_with_followersbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Spaces
X: List Spaces
/accounts/{accountId}/x/spacesGET /2/spaces/by/creator_ids (mine) | /2/spaces/search. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: /v1/accounts/{accountId}/focus/spaces.
Try it with MCPAsk your agent to call x-spaces-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringSearch Spaces; omit for your own
statestringdefault: "all"livescheduledall
creator_idsstringlimitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlytitlestringstatestringlivescheduledended
langstring | nullis_ticketedbooleanparticipant_countinteger | nullsubscriber_countinteger | nullscheduled_startstring (date-time) | nullstarted_atstring (date-time) | nullended_atstring (date-time) | nullcreator_idstringcreator_usernamestring | nullurlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Get a Spaces item
/accounts/{accountId}/x/spaces/{itemId}GET /2/spaces/:id. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: /v1/accounts/{accountId}/focus/spaces.
Try it with MCPAsk your agent to call x-spaces-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringstatestringlivescheduledended
langstring | nullis_ticketedbooleanparticipant_countinteger | nullsubscriber_countinteger | nullscheduled_startstring (date-time) | nullstarted_atstring (date-time) | nullended_atstring (date-time) | nullcreator_idstringcreator_usernamestring | nullurlstring (uri)Responses
Space posts
X: List Space posts
/accounts/{accountId}/x/space-postsGET /2/spaces/:id/tweets. Posts shared in a Space. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/space-posts.
Try it with MCPAsk your agent to call x-space-posts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
space_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlytextstringrequiredcreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlypostreplyquoterepost
author_idstringread-onlyauthor_usernamestringread-onlyauthor_namestringread-onlyauthor_avatar_urlstring (uri)read-onlyconversation_idstringread-onlyin_reply_to_user_idstring | nullread-onlyreply_to_idstring | nullread-onlyquoted_idstring | nullread-onlyreposted_idstring | nullread-onlylangstringread-onlyreply_settingsstringeveryonefollowingmentionedUserssubscribersverified
community_idstring | nullpossibly_sensitivebooleanread-onlypaid_partnershipbooleaneditable_untilstring (date-time) | nullread-onlyedits_remaininginteger | nullread-onlymediaarray of objectread-onlyShow 9 item attributes
media_keystringtypestringphotovideoanimated_gif
urlstring (uri)preview_image_urlstring (uri)widthintegerheightintegerduration_msintegeralt_textstringview_countintegerpollobject | nullShow 6 child attributes
idstringoptionsarray of objectShow 3 item attributes
positionintegerlabelstringvotesintegertotal_votesintegervoting_statusstringopenclosed
end_datetimestring (date-time)duration_minutesintegerlikesintegerread-onlyrepostsintegerread-onlyrepliesintegerread-onlyquotesintegerread-onlybookmarksintegerread-onlyimpressionsintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Space buyers
X: List Ticket buyers
/accounts/{accountId}/x/space-buyersGET /2/spaces/:id/buyers. Accounts that bought a ticket to your ticketed Space. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/space-buyers.
Try it with MCPAsk your agent to call x-space-buyers-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
space_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Broadcasts
X: List Broadcasts
/accounts/{accountId}/x/broadcastsGET /2/broadcasts. Your X Live broadcasts: live, ended and replays with viewer counts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: /v1/accounts/{accountId}/focus/broadcasts.
Try it with MCPAsk your agent to call x-broadcasts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
idsstringComma-separated broadcast ids
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
idstringread-onlytitlestring | nullstatestring | nullshare_urlstring (uri) | nullimage_urlstring (uri) | nullpost_idstring | nullchat_optioninteger | nullavailable_for_replayboolean | nulllanguagestring | nullstarted_atstring (date-time) | nullended_atstring (date-time) | nullscheduled_startstring (date-time) | nullscheduled_endstring (date-time) | nullwatchinginteger | nullwatchedinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Get a Broadcasts item
/accounts/{accountId}/x/broadcasts/{itemId}GET /2/broadcasts/:id. Your X Live broadcasts: live, ended and replays with viewer counts. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: /v1/accounts/{accountId}/focus/broadcasts.
Try it with MCPAsk your agent to call x-broadcasts-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestring | nullstatestring | nullshare_urlstring (uri) | nullimage_urlstring (uri) | nullpost_idstring | nullchat_optioninteger | nullavailable_for_replayboolean | nulllanguagestring | nullstarted_atstring (date-time) | nullended_atstring (date-time) | nullscheduled_startstring (date-time) | nullscheduled_endstring (date-time) | nullwatchinginteger | nullwatchedinteger | nullResponses
Scheduled broadcasts
X: List Scheduled broadcasts
/accounts/{accountId}/x/scheduled-broadcastsGET /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.
Try it with MCPAsk your agent to call x-scheduled-broadcasts-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–100
oldest_start_timestring (date-time)newest_start_timestring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringread-onlybroadcast_idstring | nullread-onlytitlestringdescriptionstring | nullstatestring | nullread-onlysource_idstringIngest source id (RTMP stream key)
scheduled_startstring (date-time)scheduled_endstring (date-time) | nullchat_optionstring | nullWho can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
0123456
available_for_replayboolean | nullmanual_publishboolean | nulllocalestring | nullrecurring_schedule_idstring | nullread-onlythumbnail_media_idstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Scheduled broadcasts item
/accounts/{accountId}/x/scheduled-broadcastsPOST /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.
Try it with MCPAsk your agent to call x-scheduled-broadcasts-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringdescriptionstringsource_idstringrequiredIngest source id (RTMP stream key)
scheduled_startstring (date-time)requiredscheduled_endstring (date-time)chat_optionstringWho can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
0123456
available_for_replaybooleanmanual_publishbooleanDo not auto-publish at start; call go-live
is_lockedbooleanlocalestringthumbnail_media_idstringrecurrenceobjectShow 2 child attributes
frequencystringDailyWeekly
repeatsinteger≥ 1
Returns object
idstringread-onlybroadcast_idstring | nullread-onlytitlestringdescriptionstring | nullstatestring | nullread-onlysource_idstringIngest source id (RTMP stream key)
scheduled_startstring (date-time)scheduled_endstring (date-time) | nullchat_optionstring | nullWho can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
0123456
available_for_replayboolean | nullmanual_publishboolean | nulllocalestring | nullrecurring_schedule_idstring | nullread-onlythumbnail_media_idstring | nullResponses
X: Get a Scheduled broadcasts item
/accounts/{accountId}/x/scheduled-broadcasts/{itemId}GET /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.
Try it with MCPAsk your agent to call x-scheduled-broadcasts-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlybroadcast_idstring | nullread-onlytitlestringdescriptionstring | nullstatestring | nullread-onlysource_idstringIngest source id (RTMP stream key)
scheduled_startstring (date-time)scheduled_endstring (date-time) | nullchat_optionstring | nullWho can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
0123456
available_for_replayboolean | nullmanual_publishboolean | nulllocalestring | nullrecurring_schedule_idstring | nullread-onlythumbnail_media_idstring | nullResponses
X: Update a Scheduled broadcasts item
/accounts/{accountId}/x/scheduled-broadcasts/{itemId}PUT /2/broadcasts/scheduled/:id (start and end are required by X; missing ones are read back first). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.
Try it with MCPAsk your agent to call x-scheduled-broadcasts-update (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringdescriptionstringsource_idstringIngest source id (RTMP stream key)
scheduled_startstring (date-time)scheduled_endstring (date-time)chat_optionstringWho can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
0123456
available_for_replaybooleanmanual_publishbooleanDo not auto-publish at start; call go-live
is_lockedbooleanlocalestringthumbnail_media_idstringrecurrenceobjectShow 2 child attributes
frequencystringDailyWeekly
repeatsinteger≥ 1
roll_forwardbooleanReturns object
idstringread-onlybroadcast_idstring | nullread-onlytitlestringdescriptionstring | nullstatestring | nullread-onlysource_idstringIngest source id (RTMP stream key)
scheduled_startstring (date-time)scheduled_endstring (date-time) | nullchat_optionstring | nullWho can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
0123456
available_for_replayboolean | nullmanual_publishboolean | nulllocalestring | nullrecurring_schedule_idstring | nullread-onlythumbnail_media_idstring | nullResponses
X: Delete a Scheduled broadcasts item
/accounts/{accountId}/x/scheduled-broadcasts/{itemId}DELETE /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.
Try it with MCPAsk your agent to call x-scheduled-broadcasts-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
X: Go live (Scheduled broadcasts)
/accounts/{accountId}/x/scheduled-broadcasts/{itemId}/go-livePOST /2/broadcasts/scheduled/:id/live (for manual_publish broadcasts). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.
Try it with MCPAsk your agent to call x-scheduled-broadcasts-go-live (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Broadcast chat
X: List Live chat
/accounts/{accountId}/x/broadcast-chatGET /2/broadcasts/:id/chat (item id = "<broadcast_id>:<message_id>"). Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.
Try it with MCPAsk your agent to call x-broadcast-chat-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (next_cursor)
limitinteger1–200
broadcast_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringread-onlymessage_idstringread-onlybroadcast_idstringread-onlytextstring≤ 140 characters
author_idstring | nullread-onlyauthor_usernamestring | nullread-onlyauthor_namestring | nullread-onlyreply_tostring | nullcreated_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Live chat item
/accounts/{accountId}/x/broadcast-chatPOST /2/broadcasts/:id/chat. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.
Try it with MCPAsk your agent to call x-broadcast-chat-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringrequiredtextstringrequired≤ 140 characters
reply_tostringReturns object
idstringread-onlymessage_idstringread-onlybroadcast_idstringread-onlytextstring≤ 140 characters
author_idstring | nullread-onlyauthor_usernamestring | nullread-onlyauthor_namestring | nullread-onlyreply_tostring | nullcreated_atstring (date-time) | nullread-onlyResponses
X: Delete a Live chat item
/accounts/{accountId}/x/broadcast-chat/{itemId}DELETE /2/broadcasts/:id/chat/:message_id. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.
Try it with MCPAsk your agent to call x-broadcast-chat-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
X: Mute author (Live chat)
/accounts/{accountId}/x/broadcast-chat/{itemId}/mute-authorMute author. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.
Try it with MCPAsk your agent to call x-broadcast-chat-mute-author (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
minutesintegerOmit to mute for the whole broadcast
≥ 1
remove_messagebooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Mute user (Live chat)
/accounts/{accountId}/x/broadcast-chat/mute-userMute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.
Try it with MCPAsk your agent to call x-broadcast-chat-mute-user (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringrequireduser_idstringrequiredminutesinteger≥ 1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
X: Unmute user (Live chat)
/accounts/{accountId}/x/broadcast-chat/unmute-userUnmute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.
Try it with MCPAsk your agent to call x-broadcast-chat-unmute-user (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringrequireduser_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Broadcast moderators
X: List Chat moderators
/accounts/{accountId}/x/broadcast-moderatorsGET /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.
Try it with MCPAsk your agent to call x-broadcast-moderators-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
X: Create a Chat moderators item
/accounts/{accountId}/x/broadcast-moderatorsPOST /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.
Try it with MCPAsk your agent to call x-broadcast-moderators-create (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
user_idstringrequiredReturns object
idstringrequiredread-onlyusernamestringrequiredread-onlynamestringread-onlyurlstring (uri)read-onlyavatar_urlstring (uri)read-onlydescriptionstringread-onlylocationstring | nullread-onlywebsitestring (uri) | nullread-onlycreated_atstring (date-time)read-onlyprotectedbooleanread-onlyverifiedbooleanread-onlyverified_typestring | nullread-onlybluebusinessgovernmentnone
followersintegerread-onlyfollowingintegerread-onlypostsintegerread-onlylistedintegerread-onlylikesinteger | nullread-onlymedia_countinteger | nullread-onlyResponses
X: Delete a Chat moderators item
/accounts/{accountId}/x/broadcast-moderators/{itemId}DELETE /2/broadcasts/chat/moderators/:user_id. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.
Try it with MCPAsk your agent to call x-broadcast-moderators-delete (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Account overview
X: Get Overview
/accounts/{accountId}/x/account-overviewGET /2/users/:id + GET /2/users/:id/tweets in the period. Followers and daily engagement aggregated from your posts in the period. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/account-overview.
Try it with MCPAsk your agent to call x-account-overview-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
followersintegerfollowingintegerposts_countintegerlisted_countintegerlikes_countintegermedia_countintegertotalsobjectShow 11 child attributes
impressionsintegerlikesintegercommentsintegersharesintegerquotesintegersavesintegerclicksintegerprofile_viewsintegerviewsintegerengagementsintegerengagement_ratenumberseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 11 child attributes
impressionsintegerlikesintegercommentsintegersharesintegerquotesintegersavesintegerclicksintegerprofile_viewsintegerviewsintegerengagementsintegerengagement_ratenumberposts_analyzedintegerResponses
Post metrics
X: List Post performance
/accounts/{accountId}/x/post-metricsRecent posts (or ids) with public + non-public metrics. Per-post impressions, engagements, link and profile clicks (non-public metrics for posts under 30 days). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/fundamentals/metrics Generic route: /v1/accounts/{accountId}/focus/post-metrics.
Try it with MCPAsk your agent to call x-post-metrics-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
idsstringComma-separated post ids; omit for your recent posts
limitinteger5–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringtextstringcreated_atstring (date-time)urlstring (uri)metricsobjectShow 11 child attributes
impressionsintegerlikesintegercommentsintegersharesintegerquotesintegersavesintegerclicksintegerprofile_viewsintegerviewsintegerengagementsintegerengagement_ratenumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Post analytics
X: List Post analytics (Enterprise)
/accounts/{accountId}/x/post-analyticsGET /2/tweets/analytics. Hourly/daily/weekly time series for up to 100 posts. Requires an X Enterprise contract. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/get-post-analytics Generic route: /v1/accounts/{accountId}/focus/post-analytics.
Try it with MCPAsk your agent to call x-post-analytics-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
idsstringrequiredComma-separated post ids (≤100)
sincestring (date-time)untilstring (date-time)granularitystringdefault: "daily"hourlydailyweeklytotal
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringmetricsobjectShow 11 child attributes
impressionsintegerlikesintegercommentsintegersharesintegerquotesintegersavesintegerclicksintegerprofile_viewsintegerviewsintegerengagementsintegerengagement_ratenumberseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 11 child attributes
impressionsintegerlikesintegercommentsintegersharesintegerquotesintegersavesintegerclicksintegerprofile_viewsintegerviewsintegerengagementsintegerengagement_ratenumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Media analytics
X: List Video analytics (Enterprise)
/accounts/{accountId}/x/media-analyticsGET /2/media/analytics. Video views, playback quartiles and watch time. Requires an X Enterprise contract. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Generic route: /v1/accounts/{accountId}/focus/media-analytics.
Try it with MCPAsk your agent to call x-media-analytics-list (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
media_keysstringrequiredsincestring (date-time)untilstring (date-time)granularitystringdefault: "daily"hourlydailytotal
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
media_keystringvideo_viewsintegerplayback_startintegerplayback25integerplayback50integerplayback75integerplayback_completeintegerwatch_time_msintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Usage
X: Get API usage
/accounts/{accountId}/x/usageGET /2/usage/credits + GET /2/usage/tweets (app bearer). X developer-account credit balance and daily post consumption against the monthly cap. Generic route: /v1/accounts/{accountId}/focus/usage.
Try it with MCPAsk your agent to call x-usage-get (toolset focus_x)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
total_balancenumber | nullprepaid_balancenumber | nullfree_balancenumber | nullproject_capinteger | nullproject_usageinteger | nullcap_reset_dayinteger | nullseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 1 child attributes
postsinteger