List X accounts authorized on this machine and which one is the default. Local only, no API cost.

Save the OAuth 2.0 Client ID of the user's own X App (from console.x.com) on this machine, for hosts that cannot pass the X_CLIENT_ID environment variable. Needed once before add_account. No API call.

Start OAuth 2.0 (PKCE) to authorize another X account. Returns authorize_url for the user to open in a browser logged in to that account, and a note to relay to them. mode=loopback: a local listener saves the token automatically; confirm with auth_status. mode=paste: ask the user to paste the callback URL from the address bar right after approving and pass it to complete_authorization at once. Tokens are stored only on this machine.

Check whether an authorization started with add_account has finished. Optionally wait for it.

Fallback when the automatic callback listener is unavailable: finish add_account with the full callback URL from the browser address bar (contains code and state). X codes expire ~30 seconds after approval.

Choose which authorized account is used when a tool call omits account.

Forget an authorized account on this machine and revoke its tokens at X.

Fetch the authenticated user's profile via GET /2/users/me (billed as a user read).

Publish a post as the given account; also used to reply (reply_to_post_id). Attach media via media_files (uploads for you) or media_ids. Spends pay-per-use credits (roughly $0.015 per post, much more if the text contains a URL; check current pricing in the X console). Only call when the user has confirmed the exact text and account.

Publish a thread: each post replies to the previous one. Stops at the first failure and reports what was posted. Each post is billed like create_post.

Delete a post owned by the given account (billed per request).

Interact with a post as the given account: like, unlike, repost, unrepost, bookmark, unbookmark, hide_reply or unhide_reply (replies to your own posts).

Upload an image, GIF or video and return its media_id for create_post. Images <= 5 MB go in one request; GIFs, videos and larger files use chunked upload and wait for processing. Optional alt text.

Check processing status of an uploaded video/GIF.

Search X. type=posts: posts from the last 7 days (billed per post returned, keep max_results small). type=users: search accounts by keyword.

Look up posts by ID (1-100), with author, metrics, media and referenced posts. Billed per post.

Read a timeline. type: home (your reverse-chronological home feed), posts (a user's posts), mentions, liked (posts a user liked), bookmarks (yours). user defaults to the account itself. Billed per post returned.

Who engaged with a post. type: liking_users, reposted_by (users), or quotes (quote posts).

Look up user profiles by usernames or by numeric IDs (up to 100). Billed per user.

List followers or following of a user (default: the account itself), or the account's own muting/blocking list.

Follow, unfollow, mute, unmute, block or unblock a user as the given account. X documents block as Enterprise-only, so it may be refused on pay-per-use apps.

Manage X Lists: create, update, delete, add_member, remove_member.

Read Lists. type: owned (lists a user owns, default the account), info, members, or posts of list_id.

Personalized trends for the account.