MCP action catalog

All 298 actions. In an MCP client, the ones marked loaded are tools from the start; for the rest your AI calls:

[
  {
    "tool": "find_actions",
    "arguments": {
      "query": "posting slots"
    }
  },
  {
    "tool": "run_read_action",
    "arguments": {
      "action": "scheduler.list_slots",
      "input": {}
    }
  }
]

run_write_action runs actions that change data or post, and only with your go-ahead in the conversation. With the full toolset switched on, every action below is its own tool under the name shown.

Your profile

Tool	Action	Kind	What it does
get_me	me.get	read · loaded	Load this before writing anything for the user.

Accounts

Tool	Action	Kind	What it does
list_accounts	accounts.list	read · loaded	List the X accounts this connection can act on (own, added and shared), with your role on each and which one is the default.

Context and voice

Tool	Action	Kind	What it does
get_writing_kit	context.writing_kit	read · loaded	Material for writing posts in the user’s voice: real posts that worked (their own winners, their circle this week, bookmarks, library outliers) to build each new post from, fresh facts and takes, and what they posted lately so you don’t repeat it.
update_account_context	context.update	write	Change the account’s audience, goals, product context, topics or rules that every Xholic writer reads.
context_products	context.products	read	The account’s saved products with their facts (what it is, audience, features, proof), analysis limits and removal notices.
context_bio_product_suggestion	context.bio_product_suggestion	read	The link in the account’s X bio when it isn’t a saved product yet, so it can be added with context.add_product.
context_add_product	context.add_product	write	Add a product by its website URL.
context_refresh_product	context.refresh_product	write	Read the product’s website again and update its facts.
context_set_product_auto_refresh	context.set_product_auto_refresh	write	Choose whether a product keeps refreshing automatically after its facts were edited by hand.
context_update_product	context.update_product	write	Replace a product’s facts.
context_delete_product	context.delete_product	write	Remove a product from the account’s context.
context_dismiss_product_notice	context.dismiss_product_notice	write	Hide the notice that a product was removed automatically.

Profile check

Tool	Action	Kind	What it does
profile_check	profile.check	read	Check the account’s X profile (bio, pinned post, banner, link) against what makes strangers follow, with concrete fixes.

Updates

Tool	Action	Kind	What it does
get_updates	events.updates	read · loaded	Call at the start of a conversation.

Insights

Tool	Action	Kind	What it does
whats_working	insights.whats_working	read · loaded	What worked for the account over a period and why: best posts, formats, topics and times, compared with their normal.
insights_bank	insights.bank	read	The account’s knowledge areas and the insights Xholic mined from their posts, for teaching posts.

Niche

Tool	Action	Kind	What it does
niche_now	niche.now	read · loaded	Posts proven this week in the account’s circle and niche, plus bookmarks, likes and library outliers.

Engage

Tool	Action	Kind	What it does
who_to_engage	engage.who_to_engage	read · loaded	People worth replying to right now and why: unanswered mentions, the account’s reply circle, and warm Signals leads.
engage_reply_circle	engage.reply_circle	read	The people the account trades replies with most, and who to reply to next to grow.
engage_get_consent	engage.get_consent	read	Whether the user accepted Engage’s guidelines.
engage_accept_consent	engage.accept_consent	write	Record that the user accepted Engage’s guidelines for engaging on X.
engage_list_feeds	engage.list_feeds	read	The account’s saved Engage feeds (FEEDS) or extension timelines (TIMELINE).
engage_create_feed	engage.create_feed	write	Save a feed of posts to engage with: a topic, a contact list, an X list, or one account (timelines only).
engage_create_feeds	engage.create_feeds	write	Save up to 8 Engage feeds in one call.
engage_update_feed	engage.update_feed	write	Change a saved feed.
engage_delete_feed	engage.delete_feed	write	Delete a saved Engage feed.
engage_feed	engage.feed	read	Posts to engage with from a saved feed (feedId) or an ad-hoc topic search (type TOPIC + query), top or latest.
engage_set_item_state	engage.set_item_state	write	Hide a post from Engage feeds (a skip), or mark it replied or not replied.
engage_clear_skips	engage.clear_skips	write	Bring back every post the account hid from Engage feeds.

Mentions

Tool	Action	Kind	What it does
mentions_list	mentions.list	read	The account’s latest mentions and replies to its posts, synced by Xholic.

Replies

Tool	Action	Kind	What it does
replies_mine	replies.mine	read	Replies the account sent, newest or best first.
replies_prefetch	replies.prefetch	read	Load an X post and its thread ahead of drafting a reply with Xholic’s reply writer.
replies_select_draft	replies.select_draft	write	Switch a reply generation to one of its other drafts (already paid for, free).
replies_get_settings	replies.get_settings	read	The reply writer’s custom instructions and whether replies may use the author’s name.
replies_update_settings	replies.update_settings	write	Change the reply writer’s custom instructions or whether replies may use the author’s name.

People

Tool	Action	Kind	What it does
get_person	people.get	read · loaded	Everything about one X account: profile, recent posts, and the history with the user (replies, DMs, notes, lead status).

Posts

Tool	Action	Kind	What it does
get_post	posts.get	read · loaded	Any X post by id or URL with its numbers and context.
posts_conversation	posts.conversation	read	A post’s thread and replies.
schedule_post	posts.schedule	publish · loaded	Schedule a post or thread on X at a time.
publish_now	posts.publish_now	publish · loaded	Post to X immediately.

X search

Tool	Action	Kind	What it does
search_x	x.search	read · loaded	Live X search, one page of up to 20 posts.

Inspiration

Tool	Action	Kind	What it does
search_inspiration	inspiration.search	read · loaded	Search Xholic’s library of proven posts by idea, with outlier scores (how far a post beat its author’s normal).
inspiration_explain_structure	inspiration.explain_structure	write	Xholic AI breaks down why an Inspiration post works: hook, structure and reusable pattern.

Library

Tool	Action	Kind	What it does
get_saved_posts	library.saved	read · loaded	The account’s X bookmarks and likes mirrored by Xholic, plus saved posts.
library_save	library.save	write	Save an X post to the user’s library by its id.
library_save_by_url	library.save_by_url	write	Save an X post to the user’s library from its URL.
library_unsave	library.unsave	write	Remove a post from the user’s library.

Creators

Tool	Action	Kind	What it does
creators_top_posts	creators.top_posts	read	Another creator’s best posts over a period.

Drafts

Tool	Action	Kind	What it does
check_draft	drafts.check	read · loaded	Free checks before posting: length for the account’s X tier, links (Xholic drafts never contain links), near-copies of a source post, repeats of what the account posted recently, and thread structure.
save_draft	drafts.save	write · loaded	Save a post or thread as a draft in Xholic.
draft_with_xholic	drafts.with_xholic	write · loaded	Only when the user explicitly asks for Xholic’s writer.
draft_reply_with_xholic	drafts.reply_with_xholic	write	Only when the user explicitly asks for Xholic’s reply writer.

Queue

Tool	Action	Kind	What it does
get_queue	queue.list	read · loaded	Scheduled posts and drafts, soonest first.
reschedule_post	queue.reschedule	publish · loaded	Move a queued post to a new time.
unschedule_post	queue.unschedule	write · loaded	Take a scheduled post out of the queue and keep it as a draft.
edit_queued_post	queue.edit	publish · loaded	Change the text, thread, media or automations of a draft or scheduled post.
delete_queued_post	queue.delete	write · loaded	Delete a draft or scheduled post from Xholic.
queue_counts	queue.counts	read	How many posts are queued, drafted, posted and failed.
queue_get_post	queue.get_post	read	One draft, scheduled, posted or failed post in Xholic with its text, thread, media, automations and status.
queue_post_now	queue.post_now	publish	Publish an existing draft or scheduled post to X right away.
queue_cancel	queue.cancel	write	Cancel a draft, scheduled or failed post so it never goes out.
queue_share_draft	queue.share_draft	write	Create a public read-only link to a draft so someone without Xholic can review it.
queue_revoke_share	queue.revoke_share	write	Turn off every public link to a draft.
queue_add_automation_step	queue.add_automation_step	publish	Add one automation step to a post that is already live: repost, unrepost, delete, a plug reply after enough likes, or DMs to people who reply with a keyword.
queue_update_automation_step	queue.update_automation_step	publish	Change a pending automation step on a live post.
queue_remove_automation_step	queue.remove_automation_step	write	Remove a pending automation step from a live post before it runs.

Media

Tool	Action	Kind	What it does
upload_media	media.create_upload	write · loaded	Start a media upload (image, GIF or video).
media_complete_upload	media.complete_upload	write	Mark an upload finished after the bytes were PUT to the upload URL.
media_get	media.get	read	One uploaded media item’s state.
media_preview	media.preview	read	A short-lived URL to view an uploaded media item.
media_delete	media.delete	write	Delete an uploaded media item that no post uses.
media_browse_klipy	media.browse_klipy	read	Search or browse KLIPY GIFs and memes to attach to a post.
media_import_klipy	media.import_klipy	write	Copy a KLIPY GIF or meme into the account’s media.

Content export

Tool	Action	Kind	What it does
content_export	content.export	read	The account’s posts with their numbers for a period, as data you can analyse.

Analytics

Tool	Action	Kind	What it does
get_analytics	analytics.summary	read · loaded	Totals and a daily series for a period: impressions, engagement, followers, posts and replies counted separately.
how_did_it_do	analytics.content	read · loaded	How the account’s posts performed, compared with its normal.
analytics_growth	analytics.growth	read	The follower funnel for the last 7 and 30 days (impressions to profile visits to follows), its weakest step and the profile check score.
analytics_import_status	analytics.import_status	read	Whether the account’s post history is still importing, up to date or delayed, and how far it got.
analytics_export_posts_csv	analytics.export_posts_csv	read	Every post in a period with its numbers as CSV text (up to 5,000 rows).
analytics_export_daily_csv	analytics.export_daily_csv	read	Daily totals for a period (posts, impressions, engagement, follower change) as CSV text.
analytics_list_imports	analytics.list_imports	read	X analytics CSV files imported into this account, with the days each one covered.
analytics_import_csv	analytics.import_csv	write	Import the account overview CSV exported from X analytics to fill in past days.
analytics_delete_import	analytics.delete_import	write	Remove an imported analytics file and the days it wrote.

Memory

Tool	Action	Kind	What it does
remember	memory.remember	write · loaded	Save a fact, writing preference or answer about the user to the memory every Xholic writer reads.
forget	memory.forget	write · loaded	Remove a memory the user says is wrong or outdated.
memory_list	memory.list	read	Everything the user told Xholic to remember.

Workers

Tool	Action	Kind	What it does
get_workers	workers.list	read · loaded	The account’s Workers (always-on AI writers): settings, schedule and status.
get_worker_drafts	workers.drafts	read · loaded	Drafts a Worker wrote that are waiting for review.
workers_overview	workers.overview	read	The account’s growth overview: milestones, Workers and what they produced.
workers_find_creators	workers.find_creators	read	Find X creators whose style a Worker can learn from.
create_worker	workers.create	write · loaded	Create a Worker that writes posts on a schedule or on demand.
update_worker	workers.update	write · loaded	Change a Worker’s instructions, voice, topics, products, size or schedule.
pause_or_resume_worker	workers.set_status	write · loaded	Pause or resume a Worker.
run_worker	workers.run	write · loaded	Queue a Worker to write a new batch now with Xholic’s writer.
workers_create_ready_made	workers.create_ready_made	write	Create the preset Worker built from the account’s context (voice, creators it already has posts for, products).
workers_rebuild_ready_made	workers.rebuild_ready_made	write	Refresh the ready-made Worker’s creators and brief from the account’s current context.
workers_cancel_queued_run	workers.cancel_queued_run	write	Stop a Worker run that is queued and hasn’t started yet.
workers_runs	workers.runs	read	Recent Worker runs, newest first: status, trigger, credits and why a run failed or was skipped.
workers_voice	workers.voice	read	The account’s takes (opinions) and expertise areas that Workers write from, each marked as mined or added by the user.
workers_add_take	workers.add_take	write	Add an opinion the user holds, in their words, for Workers to write from.
workers_remove_take	workers.remove_take	write	Remove a take so Workers stop writing from it.
workers_add_expertise	workers.add_expertise	write	Add a subject the account teaches, so Workers write knowledge posts about it.
workers_remove_expertise	workers.remove_expertise	write	Remove an expertise area and its insight cards.
review_worker_draft	workers.review_draft	write · loaded	Move a Worker draft: DRAFT keeps it in the user’s drafts, DISMISSED throws it away, TO_REVIEW puts it back in review.
workers_draft_feedback	workers.draft_feedback	write	Tell the Workers to write more or fewer drafts like this one.
workers_draft_meme	workers.draft_meme	write	The reaction image (GIF or meme) attached to a Worker meme draft.
workers_set_draft_meme	workers.set_draft_meme	write	Swap or remove the reaction image on a Worker meme draft.

Leads

Tool	Action	Kind	What it does
get_leads	leads.list	read · loaded	Leads found by the account’s Signals agents, hottest first, with why each one fits.
set_lead_status	leads.set_status	write · loaded	Mark a lead COLLECTED (keep), CONTACTED (reached out) or DISMISSED (not now).
rate_lead	leads.rate	write · loaded	Mark a lead as a FIT or NOT_FIT, with an optional short reason, so the Signals agent learns who to find.

Signals

Tool	Action	Kind	What it does
signals_automation_setup	signals.automation_setup	read	Every Worker and Signals agent with its settings, for planning changes.
signals_customer_brief	signals.customer_brief	read	Who the account’s customers are, what they ask, and where to find them, from Signals.
signals_draft_audience	signals.draft_audience	read	Draft who a Signals agent should find, from a product, a URL or a description.
signals_suggest_sources	signals.suggest_sources	read	Suggest keywords, profiles and lists a Signals agent should watch.
signals_test_searches	signals.test_searches	read	Try search queries on live X before an agent uses them.
create_signal_agent	signals.create_agent	write · loaded	Create an always-on agent that finds leads on X from sources and an audience description.
find_customers	signals.find_customers	write · loaded	One-click agent that finds people asking for what a product does, and its competitors’ customers.
signals_update_agent	signals.update_agent	write	Change a Signals agent’s audience, sources, rubric or schedule.
signals_set_status	signals.set_status	write	Pause or resume a Signals agent.
signals_dashboard	signals.dashboard	read	Every Signals agent with its status, sources, last run and lead counts, plus the month’s scoring quota and any ready-made or product agent that needs a rebuild.
signals_search_profiles	signals.search_profiles	read	Search X accounts by name or handle to watch in a Signals agent (Profile or Followers sources).
signals_source_details	signals.source_details	read	Names and avatars for X accounts and X lists a Signals agent watches.
signals_create_ready_made	signals.create_ready_made	write	Create the one-click Signals agent built from the account’s context and tested searches.
signals_rebuild_ready_made	signals.rebuild_ready_made	write	Refresh the ready-made Signals agent from the account’s current context.
signals_expand_ready_made	signals.expand_ready_made	write	Top the ready-made Signals agent up to the paid plan’s size with more searches from the profile, keeping its current ones.
signals_dismiss_expand	signals.dismiss_expand	write	Hide the offer to add more searches to the ready-made Signals agent, for good.
signals_rebuild_product_agent	signals.rebuild_product_agent	write	Rebuild a product’s Find customers agent after the product changed.
run_signal_agent	signals.run_agent	write · loaded	Queue a Signals agent to search for leads now instead of waiting for its schedule.
signals_runs	signals.runs	read	Recent Signals agent runs, newest first, with what each found and scored.
signals_agent_brief	signals.agent_brief	read	One Signals agent’s weekly brief: themes, questions and competitors its leads talk about, with the people and posts behind each.
signals_market_brief	signals.market_brief	read	The weekly brief across all of the account’s Signals agents: one view of what the market asks for and who to reply to.
signals_products	signals.products	read	The account’s products, each with its Find customers agent (and build progress) and competitors.

Competitors

Tool	Action	Kind	What it does
competitors_list	competitors.list	read	A product’s competitors, optionally discovering new ones.
competitors_add	competitors.add	write	Add a competitor to a product.
competitors_discover	competitors.discover	write	Find a product’s competitors and add them as suggestions to accept or dismiss.
competitors_set_status	competitors.set_status	write	ACCEPTED keeps a suggested competitor; DISMISSED removes any competitor.

Contacts

Tool	Action	Kind	What it does
get_contacts	contacts.list	read · loaded	Contacts and lists: search, filter by score or intent.
contacts_export	contacts.export	read	Contacts in a list as data.
add_to_contact_list	contacts.add_to_list	write · loaded	Add an X account to a contact list by handle.
contacts_add	contacts.add	write	Add a person Xholic already has (by X user id, e.g.
contacts_update	contacts.update	write	Change a contact’s status (NEW, SAVED, CONTACTED, DISMISSED) or its note.
contacts_remove	contacts.remove	write	Remove a contact from its list.
contacts_save_note	contacts.save_note	write	Add a note about a person, or edit one by passing its id.
contacts_delete_note	contacts.delete_note	write	Delete a note about a person.
contacts_search_profiles	contacts.search_profiles	read	Search X accounts by name or handle to add to a contact list.
contacts_profile	contacts.profile	read	Everything Xholic knows about one person: profile, lists, notes, engagement with the account, DMs and, with leadId, why they were found as a lead.
contacts_follower_import	contacts.follower_import	read	Whether the account’s own followers have been imported into Contacts, and the latest import’s progress.
contacts_import_followers	contacts.import_followers	write	Queue an import of the account’s own X followers into Contacts.
contacts_imports	contacts.imports	read	X list imports into contact lists, with their progress.
contacts_import_x_list	contacts.import_x_list	write	Queue an import of a public X list’s members into a contact list.
contacts_cancel_import	contacts.cancel_import	write	Stop a running X list import.

Audience

Tool	Action	Kind	What it does
audience_dataset	audience.dataset	read	Collect a post’s repliers, quoters or reposters, or an X list’s members, as people you can filter, research and message.

Ask Xholic

Tool	Action	Kind	What it does
ask_xholic	ask.start	write · loaded	Hand a long job to Xholic’s own agent, e.g.
ask_task	ask.task	read	Status and answer of a job started with ask_xholic or draft_with_xholic.
ask_conversations	ask.conversations	read	The user’s past Ask conversations, newest first, with search and paging.
ask_conversation	ask.conversation	read	One Ask conversation with its messages and drafts.
ask_catalog	ask.catalog	read	Ask’s models the plan can use, its built-in skills (playbooks) and the user’s custom skills.
ask_create_skill	ask.create_skill	write	Save a reusable Ask skill: a named prompt the user can run again.
ask_update_skill	ask.update_skill	write	Replace a custom Ask skill’s title, description, prompt and model.
ask_delete_skill	ask.delete_skill	write	Delete a custom Ask skill.

Action catalog

Tool	Action	Kind	What it does
find_actions	actions.find	read · loaded	Search everything Xholic can do (about 150 actions) and the docs.

Docs

Tool	Action	Kind	What it does
read_doc	docs.read	read · loaded	Read a page of the Xholic docs by path, e.g.

Scheduler

Tool	Action	Kind	What it does
scheduler_get_settings	scheduler.get_settings	read	The account’s scheduler settings: timezone, posting window, quote fallback and default post automations with saved templates.
scheduler_update_settings	scheduler.update_settings	publish	Replace the scheduler timezone and default post automations (with templates).
scheduler_set_posting_window	scheduler.set_posting_window	write	Set the hours of the day posts may go out at, or clear it with null.
scheduler_set_quote_fallback	scheduler.set_quote_fallback	write	Choose what happens when a scheduled quote post’s original is gone at publish time: post without the quote, or fail the post.
scheduler_lookup_quote	scheduler.lookup_quote	read	Preview the X post behind a URL before quoting it: author, text, time and media.
scheduler_parse_time	scheduler.parse_time	read	Turn words like “tomorrow 9am” or “next friday at noon” into an exact ISO time in the account’s timezone.
scheduler_schedule_view	scheduler.schedule_view	read	The posting calendar day by day: scheduled posts, open slots and best times, for up to 42 days.
scheduler_dashboard_summary	scheduler.dashboard_summary	read	What needs attention in the scheduler: failed posts, failed automations and what’s coming up next.
scheduler_acknowledge_alert	scheduler.acknowledge_alert	write	Mark a failed post or failed automation alert from scheduler.dashboard_summary as seen so it stops showing.
best_posting_times	scheduler.best_times	read · loaded	The best upcoming times for this account to post, from when its audience engages.
scheduler_list_slots	scheduler.list_slots	read	The account’s weekly posting slots that “next slot” scheduling fills.
scheduler_replace_slots	scheduler.replace_slots	write	Replace every weekly posting slot with this list.

Tags

Tool	Action	Kind	What it does
list_tags	tags.list	read · loaded	The account’s post tags (name, color, id).
tags_create	tags.create	write	Create a post tag.
tags_import_starter	tags.import_starter	write	Add Xholic’s starter tag set (missing ones only).
tags_update	tags.update	write	Rename a tag or change its color.
tags_delete	tags.delete	write	Delete a tag.

Composer

Tool	Action	Kind	What it does
composer_rewrite	composer.rewrite	write	Only when the user explicitly asks for Xholic’s rewriter.
composer_originality	composer.originality	write	Only when the user explicitly asks.
composer_mention_suggestions	composer.mention_suggestions	read	X accounts matching a partial handle, from Xholic’s data first.

Remix

Tool	Action	Kind	What it does
remix_generate	remix.generate	write	Only when the user explicitly asks for Xholic’s remixer.
remix_select_draft	remix.select_draft	write	Switch a remix to another of its drafts.
remix_post	remix.post	publish	Post a remix to X now, optionally with edited text.
remix_history	remix.history	read	Past remixes with their source posts and drafts, newest first.
remix_list_presets	remix.list_presets	read	The account’s saved custom instructions for remixing.
remix_create_preset	remix.create_preset	write	Save a named custom instruction for remixing.
remix_update_preset	remix.update_preset	write	Change a remix preset’s label and instruction.
remix_delete_preset	remix.delete_preset	write	Delete a remix preset.

Collections

Tool	Action	Kind	What it does
collections_list	collections.list	read	The user’s saved-post collections with counts.
collections_create	collections.create	write	Create a collection for saved posts.
collections_hooks	collections.hooks	write	Get the user’s Hooks collection (for saved hook ideas), creating it if it doesn’t exist.
collections_move	collections.move	write	Put a saved post in a collection, or take it out with collectionId null.
collections_reorder	collections.reorder	write	Set the display order of collections, by id.
collections_rename	collections.rename	write	Rename a collection or change its emoji (null removes it).
collections_delete	collections.delete	write	Delete a collection.

Articles

Tool	Action	Kind	What it does
articles_list	articles.list	read	The account’s X Articles (drafts, scheduled, published), newest first.
create_article	articles.create	write · loaded	Start a new X Article draft with a title.
articles_eligibility	articles.eligibility	read	Whether the X account can publish Articles (X requires Premium) and why not.
articles_cover_usage	articles.cover_usage	read	How many AI article covers are left today and this period.
articles_get	articles.get	read	One article with its title, subtitle, document, assets, status and version.
update_article	articles.update	write · loaded	Save an article’s title, subtitle or body.
articles_delete	articles.delete	write	Delete an article from Xholic.
articles_duplicate	articles.duplicate	write	Copy an article into a new draft.
articles_ai_run	articles.ai_run	write	Only when the user explicitly asks for Xholic’s article AI.
articles_create_asset_upload	articles.create_asset_upload	write	Start an image upload for an article cover or inline image.
articles_finalize_asset	articles.finalize_asset	write	Mark an article image upload finished after the bytes were PUT to the upload URL.
articles_import_klipy	articles.import_klipy	write	Copy a KLIPY GIF or meme (from media.browse_klipy) into an article as its cover or an inline image.
articles_delete_asset	articles.delete_asset	write	Remove an image from an article.
schedule_article	articles.schedule	publish · loaded	Schedule an article to publish on X at a time.
publish_article	articles.publish	publish · loaded	Publish an article to X now.
articles_cancel_schedule	articles.cancel_schedule	write	Take a scheduled article out of the queue; it stays a draft.

Contact lists

Tool	Action	Kind	What it does
get_contact_lists	contact_lists.list	read · loaded	The account’s contact lists with member counts, including which one is the close-accounts list.
contact_lists_create	contact_lists.create	write	Create a contact list.
contact_lists_rename	contact_lists.rename	write	Rename a contact list.
contact_lists_delete	contact_lists.delete	write	Delete a contact list and its memberships.
contact_lists_set_close_accounts	contact_lists.set_close_accounts	write	Turn a list into the account’s close-accounts list (people whose posts Home and Engage surface first), or turn that off.

Direct messages

Tool	Action	Kind	What it does
dm_dashboard	dm.dashboard	read	Direct messages at a glance: sender state (paused, stopped, needs reconnect), today’s usage and limits, active campaigns and unread replies.
dm_preview_recipients	dm.preview_recipients	write	Find people to message from a post’s repliers, a search, handles, an X list, recent interactions or a contact list, with whether each can be messaged.
send_dms	dm.quick_send	publish · loaded	Send one message to up to 500 people found with dm.preview_recipients, paced safely from the user’s X account.
dm_control_queue	dm.control_queue	publish	PAUSE_ALL holds every queued DM, RESUME_ALL continues, CANCEL_ALL_PENDING cancels everything not sent yet, ENABLE_SENDING turns DMs back on after a stop.
dm_stop_all	dm.stop_all	write	Emergency stop: cancel every pending DM and stop sending until turned back on with dm.control_queue ENABLE_SENDING.
dm_campaigns	dm.campaigns	read	The account’s DM campaigns with status and totals, newest first.
create_dm_campaign	dm.create_campaign	write · loaded	Create a draft DM campaign for a contact list.
dm_campaign	dm.campaign	read	One DM campaign: steps, variants, schedule, rules and totals.
dm_update_campaign	dm.update_campaign	write	Replace a draft campaign’s settings: send the whole draft (read it with dm.campaign first).
dm_control_campaign	dm.control_campaign	publish	PAUSE or RESUME a running campaign, or CANCEL_PENDING to cancel its unsent messages.
dm_delete_campaign	dm.delete_campaign	write	Delete a DM campaign that hasn’t launched.
dm_review_campaign	dm.review_campaign	read	Check a draft campaign before launch: who can be messaged, who is skipped and why, missing variables, and the outreach guidelines the user must accept.
launch_dm_campaign	dm.launch_campaign	publish · loaded	Launch a reviewed campaign: its messages start sending on its schedule.
dm_preview_campaign	dm.preview_campaign	write	Render a campaign step’s message for a few recipients exactly as it will be sent.
dm_duplicate_campaign	dm.duplicate_campaign	write	Copy a campaign’s steps and settings into a new draft.
dm_campaign_recipients	dm.campaign_recipients	read	A campaign’s recipients with each one’s status, step and reply.
get_dm_campaign_stats	dm.campaign_stats	read · loaded	How a campaign is doing: sent, replied, interested and booked, by step and A/B variant.
dm_export_campaign	dm.export_campaign	read	A campaign’s recipients and results as CSV.
dm_today	dm.today	read	Messages from ASSISTED campaigns ready for the user to send by hand today, with the rendered text and a link to each person’s DMs.
dm_mark_assisted_sent	dm.mark_assisted_sent	write	Record that the user sent an assisted DM by hand.
dm_undo_assisted_sent	dm.undo_assisted_sent	write	Put an assisted DM back in today’s queue within a minute of marking it sent.
dm_skip_recipient	dm.skip_recipient	write	Skip one person in a campaign so they aren’t messaged.
dm_cancel_recipient	dm.cancel_recipient	write	Cancel a DM that is queued but not sent yet.
get_dm_inbox	dm.inbox	read · loaded	DM conversations with replies, newest first, with each person’s lead status.
dm_thread	dm.thread	read	The full DM conversation with one person.
dm_update_conversation	dm.update_conversation	write	Set a conversation’s lead status (e.g.
reply_to_dm	dm.reply	publish · loaded	Send a DM reply in a conversation from the user’s X account.
dm_suggest_reply	dm.suggest_reply	write	Have Xholic’s AI suggest a reply in a DM conversation.
dm_lists	dm.lists	read	Contact lists available for DM campaigns, with sizes, custom fields and how many can be messaged.
dm_estimate_import	dm.estimate_import	read	Estimate how many profiles an import (followers, following, keyword posters, X list, post engagers or handles) would bring in and what it uses of the plan’s import pool.
dm_queue_import	dm.queue_import	write	Queue an import of X profiles into a contact list for DM campaigns.
dm_import_csv	dm.import_csv	write	Import handles and custom fields from CSV text (up to 200 KB) into a contact list.
dm_imports	dm.imports	read	Lead imports with their progress, optionally for one list.
dm_cancel_import	dm.cancel_import	write	Stop a running lead import.
dm_settings	dm.settings	read	Default delivery mode, schedule and rules for new campaigns, the assisted daily limit and opt-out phrases.
dm_update_settings	dm.update_settings	write	Replace the DM settings: send all of them (read them with dm.settings first).
dm_suppressions	dm.suppressions	read	People the account will never DM.
dm_suppress	dm.suppress	write	Add a person to the do-not-message list and cancel their pending DMs.
dm_bulk_suppress	dm.bulk_suppress	write	Add many handles to the do-not-message list at once and cancel their pending DMs.
dm_unsuppress	dm.unsuppress	write	Remove a person from the do-not-message list.
dm_inbound_rules	dm.inbound_rules	read	Keyword rules that DM people automatically when they message or reply with a word like GUIDE.
dm_create_inbound_rule	dm.create_inbound_rule	publish	Add a rule that automatically DMs replyTemplate to anyone who sends the keyword.
dm_update_inbound_rule	dm.update_inbound_rule	publish	Replace a keyword rule’s keyword, reply or active state.
dm_delete_inbound_rule	dm.delete_inbound_rule	write	Delete a keyword rule.

Home

Tool	Action	Kind	What it does
home_feed	home.feed	read	The account’s Home: overview numbers, the welcome drafts after sign-up, and up to five ranked cards for today (mentions to answer, leads, queue gaps, posts taking off, trends).
home_card_action	home.card_action	write	Mark a Home card done, dismiss it, snooze it or restore it, by the key and type home.feed returned.
home_welcome_action	home.welcome_action	write	Act on the welcome drafts shown after sign-up: dismiss-message hides the intro, dismiss-draft or restore-draft one draft by position, retry rebuilds drafts that failed.

Settings

Tool	Action	Kind	What it does
settings_account	settings.account	read	The signed-in Xholic user’s account: name, email, avatar and whether their main X login is still connected.
settings_reply_preferences	settings.reply_preferences	read	The account’s custom rules for reply drafts (what every Xholic reply writer must follow).
settings_update_reply_preferences	settings.update_reply_preferences	write	Replace the account’s custom reply rules.
settings_about_you	settings.about_you	read	The account’s About You settings as Stark shows them: the free-text description, selected topics and tones.
settings_set_account_type	settings.set_account_type	write	Tell Xholic whether the account is a person, a brand or a topic page, which changes the voice every writer uses.
settings_suggest_interests	settings.suggest_interests	write	Suggest About You topics from the account’s recent posts.
settings_personalization	settings.personalization	read	The account’s audience override, style vocabulary override and global rules that every writer reads, plus the generated style guide.
settings_update_personalization	settings.update_personalization	write	Replace the audience override, style vocabulary override and global rules.
settings_regenerate_style_guide	settings.regenerate_style_guide	write	Rebuild the account’s writing style guide from its posts and style creators.
settings_style_creators	settings.style_creators	read	The up to 3 creators the account writes like (favourite creators), with the current count.
settings_search_style_creators	settings.search_style_creators	read	Search X creators to write like, by name or handle (at least 2 characters).
settings_add_style_creator	settings.add_style_creator	write	Add one creator to write like (up to 3).
settings_save_style_creators	settings.save_style_creators	write	Replace the creators to write like with this list (up to 3).
settings_usage	settings.usage	read	The user’s external X data usage per feature over the last few days (default 30).
settings_quota	settings.quota	read	What the plan allows today per feature and how much is used.

Billing

Tool	Action	Kind	What it does
billing_status	billing.status	read	The user’s plan and subscription state, including trial dates.
billing_details	billing.details	read	The billing details on file for the subscription.
billing_payments	billing.payments	read	Past payments and invoices.
billing_credit_packs	billing.credit_packs	read	The AI credit packs the user can buy and their prices.
billing_trial_eligibility	billing.trial_eligibility	read	Whether a checkout would still include the free trial for this user.

Sharing

Tool	Action	Kind	What it does
sharing_list	sharing.list	read	Who the user shared their X accounts with and which accounts others shared with them, with roles and pending invites.

Free tools

Tool	Action	Kind	What it does
x_profile_report	free_tools.profile_report	read	A free report on any public X account.
shadowban_check	free_tools.shadowban_check	read	Check whether a public X account looks shadowbanned or limited in search, replies and suggestions.
x_trend_regions	free_tools.trend_regions	read	The regions X trends are available for, with their region slugs for x_trends.
x_trends	free_tools.trends	read	What is trending on X in a region right now (from Xholic’s recent snapshot).
read_thread	free_tools.read_thread	read	Unroll an X thread from the link to any of its posts into one readable piece, with its media.
card_preview	free_tools.card_preview	read	Show how a link will look as a card on X (title, description, image, card type) and what is missing from its tags.
x_post_media	free_tools.post_media	read	Get download links for the video, GIF or images in a public X post.
x_username_check	free_tools.username_check	read	Whether an X username is available, with similar available suggestions when it is taken.
x_id_converter	free_tools.x_id_convert	read	Convert between an X username and its numeric user id, in either direction.
x_follower_count	free_tools.follower_count	read	The current follower and following counts of a public X account.
x_account_worth	free_tools.account_worth	read	An estimate of what a public X account is worth, from its followers, views and engagement on recent posts.
engagement_calculator	free_tools.engagement_calculator	read	Calculate engagement rates from numbers you already have (followers, impressions, likes, replies, reposts, quotes).