Suggestions actions
2 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.
Keep as is
Section titled “Keep as is”suggestions.keep · write
The owner is happy with something Xholic suggested changing (for example their bio in the profile check): stop suggesting it and leave it out of the score until that part changes. Only when the user says so. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
dismiss_suggestion. Loaded by default in MCP clients. - REST:
POST /v1/suggestions/keep - CLI:
xholic suggestions keep - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
kind |
“profile_check” | No | Default: "profile_check". |
id |
string ≤ 40 chars | Yes | The suggestion’s id, e.g. a profile check id such as “bio”. |
account |
string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection’s default account. |
note |
string ≤ 20000 chars | No | Optional, on any tool: one or two sentences for Xholic’s shared memory about what the user just decided, asked for or said about themselves or their plans (e.g. “Dropping threads for now; focusing on replies to founders”). Every AI the user connects reads it, so they never repeat themselves. In your words, never other people’s posts. Leave it out when nothing new was said. |
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. |
Suggest it again
Section titled “Suggest it again”suggestions.restore · write
Undo Keep as is: Xholic suggests that change again and counts it in the score. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
restore_suggestion. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/suggestions/restore - CLI:
xholic suggestions restore - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
kind |
“profile_check” | No | Default: "profile_check". |
id |
string ≤ 40 chars | Yes | The suggestion’s id, e.g. a profile check id such as “bio”. |
account |
string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection’s default account. |
note |
string ≤ 20000 chars | No | Optional, on any tool: one or two sentences for Xholic’s shared memory about what the user just decided, asked for or said about themselves or their plans (e.g. “Dropping threads for now; focusing on replies to founders”). Every AI the user connects reads it, so they never repeat themselves. In your words, never other people’s posts. Leave it out when nothing new was said. |
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. |
