Settings actions
15 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.
Xholic account
Section titled “Xholic account”settings.account · read
The signed-in Xholic user’s account: name, email, avatar and whether their main X login is still connected.
- MCP tool:
settings_account. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/account - CLI:
xholic settings account - Scope:
read - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
read
Input
No input.
Reply rules
Section titled “Reply rules”settings.reply_preferences · read
The account’s custom rules for reply drafts (what every Xholic reply writer must follow).
- MCP tool:
settings_reply_preferences. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/reply-preferences - CLI:
xholic settings reply-preferences - 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 rules
Section titled “Update reply rules”settings.update_reply_preferences · write
Replace the account’s custom reply rules. Read settings.reply_preferences first; null or leaving it out clears the rules. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
settings_update_reply_preferences. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/update-reply-preferences - CLI:
xholic settings update-reply-preferences - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
customRules |
string ≤ 500 chars or null | 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. |
About You settings
Section titled “About You settings”settings.about_you · read
The account’s About You settings as Stark shows them: the free-text description, selected topics and tones. To change them use update_account_context.
- MCP tool:
settings_about_you. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/about-you - CLI:
xholic settings about-you - 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. |
Set account type
Section titled “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. Pass null to go back to the detected type. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
settings_set_account_type. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/set-account-type - CLI:
xholic settings set-account-type - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
override |
“PERSON” \ | “BRAND” \ | “TOPIC” or null |
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. |
Suggest topics
Section titled “Suggest topics”settings.suggest_interests · write
Suggest About You topics from the account’s recent posts. Free, a few per day; it changes nothing until the user saves them.
- MCP tool:
settings_suggest_interests. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/suggest-interests - CLI:
xholic settings suggest-interests - Scope:
write - 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. |
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. |
Example: Suggest topics
curl https://api.xholic.ai/v1/settings/suggest-interests \ -H "Authorization: Bearer $XHOLIC_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'Personalization settings
Section titled “Personalization settings”settings.personalization · read
The account’s audience override, style vocabulary override and global rules that every writer reads, plus the generated style guide.
- MCP tool:
settings_personalization. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/personalization - CLI:
xholic settings personalization - 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 personalization
Section titled “Update personalization”settings.update_personalization · write
Replace the audience override, style vocabulary override and global rules. Read settings.personalization first and send all three: any field left out is cleared. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
settings_update_personalization. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/update-personalization - CLI:
xholic settings update-personalization - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
audienceOverride |
string ≤ 600 chars or null | No | |
styleVocabularyOverride |
string ≤ 1000 chars or null | No | |
globalRules |
string ≤ 500 chars or null | 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. |
Rebuild the style guide
Section titled “Rebuild the style guide”settings.regenerate_style_guide · write
Rebuild the account’s writing style guide from its posts and style creators. Free, capped per day; it replaces the current guide. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
settings_regenerate_style_guide. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/regenerate-style-guide - CLI:
xholic settings regenerate-style-guide - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
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. |
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. |
Style creators
Section titled “Style creators”settings.style_creators · read
The up to 3 creators the account writes like (favourite creators), with the current count.
- MCP tool:
settings_style_creators. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/style-creators - CLI:
xholic settings style-creators - 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. |
Find style creators
Section titled “Find style creators”settings.search_style_creators · read
Search X creators to write like, by name or handle (at least 2 characters). Returns creator ids for settings.add_style_creator.
- MCP tool:
settings_search_style_creators. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/search-style-creators - CLI:
xholic settings search-style-creators - 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 |
|---|---|---|---|
q |
string ≤ 100 chars | Yes | |
account |
string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection’s default account. |
Add a style creator
Section titled “Add a style creator”settings.add_style_creator · write
Add one creator to write like (up to 3). Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
settings_add_style_creator. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/add-style-creator - CLI:
xholic settings add-style-creator - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
creatorId |
string ≤ 120 chars | Yes | Creator id from settings.search_style_creators. |
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. |
Set style creators
Section titled “Set style creators”settings.save_style_creators · write
Replace the creators to write like with this list (up to 3). Leaving one out removes it. Call it only when the user asked for this in the conversation; never on your own initiative.
- MCP tool:
settings_save_style_creators. Catalog: reach it withfind_actionsandrun_write_action, or turn on the full toolset. - REST:
POST /v1/settings/save-style-creators - CLI:
xholic settings save-style-creators - Scope:
write - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
write
Input
| Field | Type | Required | Description |
|---|---|---|---|
creatorIds |
array of string ≤ 120 chars (max 3) | Yes | |
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. |
X data usage
Section titled “X data usage”settings.usage · read
The user’s external X data usage per feature over the last few days (default 30).
- MCP tool:
settings_usage. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/usage - CLI:
xholic settings usage - Scope:
read - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
read
Input
| Field | Type | Required | Description |
|---|---|---|---|
days |
integer 1–90 | No | |
account |
string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection’s default account. |
Daily limits
Section titled “Daily limits”settings.quota · read
What the plan allows today per feature and how much is used. Check it before a batch so a limit doesn’t stop it halfway.
- MCP tool:
settings_quota. Catalog: reach it withfind_actionsandrun_read_action, or turn on the full toolset. - REST:
GET /v1/settings/quota - CLI:
xholic settings quota - Scope:
read - Plan: Every plan, including the trial
- Cost: Free.
- Rate limit bucket:
read
Input
| Field | Type | Required | Description |
|---|---|---|---|
details |
boolean | No | Include the per-feature breakdown. |
account |
string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection’s default account. |