Skip to content

Insights actions

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

insights.whats_working · read

What worked for the account over a period and why: best posts, formats, topics and times, compared with their normal. Use it before planning content.

  • MCP tool: whats_working. Loaded by default in MCP clients.
  • REST: GET /v1/insights/whats-working
  • CLI: xholic insights whats-working
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

Field Type Required Description
range “today” \ “7d” \ “14d” \
timezone string ≤ 80 chars No Default: "UTC".
account string ≤ 64 chars No X account to act on, as @handle. Leave it out to use the connection’s default account.

insights.bank · read

The account’s knowledge areas and the insights Xholic mined from their posts, for teaching posts.

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

Input

Field Type Required Description
areaId string ≤ 64 chars No Only cards for this area, by its id from an earlier call.
limit integer 1–10 No Default: 6.
account string ≤ 64 chars No X account to act on, as @handle. Leave it out to use the connection’s default account.