# Replies actions

> Replies: 5 Xholic actions (3 read, 2 change), each with its MCP tool, REST endpoint and CLI command.

Source: https://docs.xholic.ai/actions/replies/

5 actions. Every field marked *Required* must be sent; `account`, `dryRun`, `idempotencyKey`, `confirmCredits` and `quoteId` are the [control fields](/api/responses/#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" \\| "ENGAGEMENT" | No | Default: `"RECENT"`. |
| `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. |