Replies actions

5 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.

My replies

replies.mine · read

Replies the account sent, newest or best first.

• MCP tool: replies_mine. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
• REST: GET /v1/replies/mine
• CLI: xholic replies mine
• Scope: read
• Plan: Every plan, including the trial
• Cost: Free.
• Rate limit bucket: read

Input

Field	Type	Required	Description
sort	“RECENT” \	“VIEWS” \	“LIKES” \
account	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.

Warm up a reply

replies.prefetch · read

Load an X post and its thread ahead of drafting a reply with Xholic’s reply writer. Free; no AI.

• MCP tool: replies_prefetch. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
• REST: GET /v1/replies/prefetch
• CLI: xholic replies prefetch
• Scope: read
• Plan: Every plan, including the trial
• Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
• Rate limit bucket: live_x

Input

Field	Type	Required	Description
tweetId	string	Yes	X post id (digits).
account	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.

Pick another reply draft

replies.select_draft · write

Switch a reply generation to one of its other drafts (already paid for, free). Teaches the reply writer which drafts the user prefers.

• MCP tool: replies_select_draft. Catalog: reach it with find_actions and run_write_action, or turn on the full toolset.
• REST: POST /v1/replies/select-draft
• CLI: xholic replies select-draft
• Scope: write
• Plan: Every plan, including the trial
• Cost: Free.
• Rate limit bucket: write

Input

Field	Type	Required	Description
tweetId	string	Yes	X post id (digits).
generationId	string	Yes	The reply generation id.
index	integer 0–3	Yes	0 is the main draft, 1 the first alternative, and so on.
account	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.
dryRun	boolean	No	Return exactly what would happen without doing it.
idempotencyKey	string ≤ 200 chars	No	A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice.

Reply writer settings

replies.get_settings · read

The reply writer’s custom instructions and whether replies may use the author’s name.

• MCP tool: replies_get_settings. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
• REST: GET /v1/replies/get-settings
• CLI: xholic replies get-settings
• Scope: read
• Plan: Every plan, including the trial
• Cost: Free.
• Rate limit bucket: read

Input

Field	Type	Required	Description
account	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.

Update reply writer settings

replies.update_settings · write

Change the reply writer’s custom instructions or whether replies may use the author’s name. Send at least one. Call it only when the user asked for this in the conversation; never on your own initiative.

• MCP tool: replies_update_settings. Catalog: reach it with find_actions and run_write_action, or turn on the full toolset.
• REST: POST /v1/replies/update-settings
• CLI: xholic replies update-settings
• Scope: write
• Plan: Every plan, including the trial
• Cost: Free.
• Rate limit bucket: write

Input

Field	Type	Required	Description
customInstructions	string ≤ 500 chars or null	No
includeAuthorName	boolean	No
account	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.
dryRun	boolean	No	Return exactly what would happen without doing it.
idempotencyKey	string ≤ 200 chars	No	A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice.