Context and voice actions

Markdown Ask ChatGPT Ask Claude

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

Writing kit

context.writing_kit · read

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. Write the posts yourself from this kit, one subject per post, then run check_draft. Never copy a source post’s claims or numbers as the user’s own.

MCP tool: get_writing_kit. Loaded by default in MCP clients.
REST: GET /v1/context/writing-kit
CLI: xholic context writing-kit
Scope: read
Plan: Every plan, including the trial
Cost: Free.
Rate limit bucket: read

Input

Field	Type	Required	Description
`topic`	string ≤ 200 chars	No	Optional subject to pull material for.
`limit`	integer 1–20	No
`account`	string ≤ 64 chars	No	X account to act on, as @handle. Leave it out to use the connection’s default account.

Update account context

context.update · write

Change the account’s audience, goals, product context, topics or rules that every Xholic writer reads. Call it only when the user asked for this in the conversation; never on your own initiative.

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

Input

Field	Type	Required	Description
`targetAudience`	string ≤ 2000 chars or null	No
`contentGoals`	string ≤ 2000 chars or null	No
`productContext`	string ≤ 6000 chars or null	No
`selectedTopics`	array of string ≤ 120 chars (max 30)	No
`accountRules`	string ≤ 500 chars or null	No	The account’s writing rules, applied to every draft: short lines such as “No hashtags.” At most 500 characters, so keep only the rules that matter most. Replaces the saved rules, so include any existing rules to keep. Null clears them.
`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.

Products and context

context.products · read

The account’s saved products with their facts (what it is, audience, features, proof), analysis limits and removal notices. Writers and Signals read these facts.

MCP tool: context_products. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
REST: GET /v1/context/products
CLI: xholic context products
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.

Product from the bio link

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.

MCP tool: context_bio_product_suggestion. Catalog: reach it with find_actions and run_read_action, or turn on the full toolset.
REST: GET /v1/context/bio-product-suggestion
CLI: xholic context bio-product-suggestion
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.

Add a product

context.add_product · write

Add a product by its website URL. Xholic reads the site and saves its facts; this counts against the plan’s daily product analyses. Call it only when the user asked for this in the conversation; never on your own initiative.

MCP tool: context_add_product. Catalog: reach it with find_actions and run_write_action, or turn on the full toolset.
REST: POST /v1/context/add-product
CLI: xholic context add-product
Scope: write
Plan: Every plan, including the trial
Cost: Free.
Rate limit bucket: write
Undo: from the activity log, which runs context.delete_product

Input

Field	Type	Required	Description
`url`	string ≤ 2048 chars	Yes	The product’s website.
`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: Add a product

curl https://api.xholic.ai/v1/context/add-product \
  -H "Authorization: Bearer $XHOLIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Refresh a product

context.refresh_product · write

Read the product’s website again and update its facts. Counts against the plan’s daily product analyses. Call it only when the user asked for this in the conversation; never on your own initiative.

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

Input

Field	Type	Required	Description
`productId`	string ≤ 120 chars	Yes	Product id from context.products.
`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.

Product auto-refresh

context.set_product_auto_refresh · write

Choose whether a product keeps refreshing automatically after its facts were edited by hand. Call it only when the user asked for this in the conversation; never on your own initiative.

MCP tool: context_set_product_auto_refresh. Catalog: reach it with find_actions and run_write_action, or turn on the full toolset.
REST: POST /v1/context/set-product-auto-refresh
CLI: xholic context set-product-auto-refresh
Scope: write
Plan: Every plan, including the trial
Cost: Free.
Rate limit bucket: write

Input

Field	Type	Required	Description
`productId`	string ≤ 120 chars	Yes	Product id from context.products.
`whenEdited`	boolean	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.

Edit product facts

context.update_product · write

Replace a product’s facts. Read them with context.products, change what the user asked, and send the whole structuredFacts object back: lists left out are cleared. Call it only when the user asked for this in the conversation; never on your own initiative.

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

Input

Field	Type	Required	Description
`productId`	string ≤ 120 chars	Yes	Product id from context.products.
`structuredFacts`	object	Yes	The product’s full facts object (name, tagline, summary, audience, features, benefits, proofPoints…) as context.products returns it.
`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.

Remove a product

context.delete_product · write

Remove a product from the account’s context. Writers and Signals stop using it. Call it only when the user asked for this in the conversation; never on your own initiative.

MCP tool: context_delete_product. Catalog: reach it with find_actions and run_write_action, or turn on the full toolset.
REST: POST /v1/context/delete-product
CLI: xholic context delete-product
Scope: write. Destructive: it can’t be taken back
Plan: Every plan, including the trial
Cost: Free.
Rate limit bucket: write

Input

Field	Type	Required	Description
`productId`	string ≤ 120 chars	Yes	Product id from context.products.
`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.

Dismiss a removal notice

context.dismiss_product_notice · write

Hide the notice that a product was removed automatically.

MCP tool: context_dismiss_product_notice. Catalog: reach it with find_actions and run_write_action, or turn on the full toolset.
REST: POST /v1/context/dismiss-product-notice
CLI: xholic context dismiss-product-notice
Scope: write
Plan: Every plan, including the trial
Cost: Free.
Rate limit bucket: write

Input

Field	Type	Required	Description
`productId`	string ≤ 120 chars	Yes	Product id from context.products.
`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.