Create a draft social post for a channel (currently only "x"). Supports text, threads (parts), polls, media paths, quote, community, and paid partnership. RULE: never put http(s) links in the main post (text / parts[0]) — put every URL in a follow-up thread part (parts[1], parts[2], …). Only set allowLinksInMainPost=true if the user explicitly forces a link in the main post. The draft is saved locally and is NOT published until it is approved and then explicitly published.

List locally stored drafts, optionally filtered by status.

Fetch a single draft by id.

Edit a draft's content (text, parts, poll, media, quote, community, paid partnership). Same link rule as create_draft: no http(s) URLs in the main post unless allowLinksInMainPost is true (only when the user explicitly insists). Pass null to clear an optional field. If the draft was already approved, this resets it back to "draft" status so it must be re-approved before publishing. To change a live post, use edit_published_draft.

Mark a draft as approved by the human user. Only approved drafts can be published. Only call this after the user has explicitly reviewed and approved the draft text.

Mark a draft as rejected. Rejected drafts cannot be published. Also usable to reconcile a draft stuck in "publishing" after a crashed publish_draft call once you have verified the post did NOT go out on X. If live post ids were already recorded (partial thread publish), call delete_published_draft instead.

Publish an approved draft to X via the X API v2. Supports threads, polls, media, quotes, community posts, and paid partnership. Fails if the draft has not been approved yet (unless approval is disabled in config). Returns the live post URL(s).

Delete every live post id recorded on a draft (the root and any thread replies), then mark the local draft as deleted. Works whenever live ids are recorded — published drafts, partial "publishing" failures, or corrupt/legacy records. Own posts only.

Edit the root post of a published draft via POST /2/tweets with edit_options.previous_post_id. Requires X Premium; edits are limited (~30 minutes / 5 edits) and each edit creates a new post id (stored locally). Re-attaches media (re-uploaded from mediaPaths) and quoteTweetId when present. Polls and community posts cannot be edited. Only the thread root is edited. Same link rule: no http(s) URL in the root unless allowLinksInMainPost is true (or was already set on the draft) because the user explicitly insisted.

Check whether this MCP server is connected to an X account and, if so, return the account's username and id.

Resolve an X @handle to a user id (and whether they can receive DMs from you). Useful before create_dm_draft.

Show local DM send rate limits and current usage (hourly, daily, min interval between sends).

Create a draft direct message. Requires recipientId or recipientUsername (or conversationId for an existing thread). NOT sent until approved and send_dm_draft is called. Supports one optional media attachment.

List locally stored DM drafts, optionally filtered by status.

Fetch a single DM draft by id.

Edit a DM draft. Pass null to clear optional fields. Resets approved drafts back to draft status.

Mark a DM draft approved. Only approved drafts can be sent. Call only after the user explicitly reviewed the message.

Mark a DM draft rejected. Also usable to reconcile a draft stuck in sending after a failed attempt.

Send an approved DM draft via the X API. Enforces local rate limits (hourly, daily, min interval). Requires dm.read and dm.write scopes (re-auth after upgrade).

Read recent DM events in a 1:1 conversation with a participant (newest first, up to 100). Requires dm.read scope.

Read recent DM events across all conversations (inbox view). Requires dm.read scope.

Read recent DM events in a conversation by conversationId (works for group and 1:1 threads).

Fetch lifetime public metrics (impressions, likes, reposts, replies, quotes, bookmarks) for up to 100 post ids. Read-only.

Summarize your account using GET /2/tweets/analytics: calendar-day impressions and engagements (aligned with x.com account analytics), period totals, and top posts for the window. Read-only; no local DB.

Analyze when you post vs average lifetime impressions by hour of day. Derived from your recent timeline; read-only, no DB.

Create a draft retweet or undo-retweet action. NOT executed until approved and retweet_post or undo_retweet is called. Pass the numeric post id from an X URL (e.g. .../status/1234567890).

List retweet/undo drafts, optionally filtered by status.

Fetch a single retweet/undo draft by id.

Mark a retweet/undo draft approved. Only approved drafts can be executed. Call only after the user explicitly reviewed the action.

Mark a retweet/undo draft rejected. Also usable to reconcile a draft stuck in executing after a failed attempt.

Retweet an approved draft to X immediately via POST /2/users/:id/retweets. Requires tweet.write scope.

Undo an approved retweet draft on X immediately via DELETE /2/users/:id/retweets/:tweet_id. Requires tweet.write scope.

Discover what's trending right now on X within a specific product niche, so you can ride the conversation for engagement. Searches recent X posts scoped to the niche/keywords, not X's generic global trending list (which rarely surfaces niche topics), filters out spam and near-duplicates, and returns algorithmically scored trending topics with real sample tweets and engagement numbers, real demand-signal posts (people asking for recommendations/alternatives), and a post-timing recommendation. This tool does not generate content itself: after calling it, use the returned trendingTopics and painPointSignals, plus the product's name/description/audience from this conversation, to write natural, platform-appropriate content (tweet, thread, LinkedIn post, Bluesky post, Reddit title, Hacker News title) that connects the product to the trend. Avoid AI-sounding phrasing, do not fabricate engagement numbers, and ground any claims in the sample tweets returned.