Insights actions
2 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.
What’s working
Section titled “What’s working”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. |
Insight bank
Section titled “Insight bank”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 withfind_actionsandrun_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. |
