Account and credits
Check the workspace, balance and prices, and send the user a top-up link.
Start every session with get_account, and call quote_cost before any paid tool.
get_account
get_accountread-onlyWorkspaces, plan, credit balance, prices and today's agent spend. Call this first.
| Parameter | Type | Default | Limits |
|---|---|---|---|
workspace_id | string | | 1–100 chars |
quote_cost
quote_costread-onlyPrice an action before doing it. For analysis pass the creator handles (new analysis) or analysis_id (re-run): re-analyses of creators seen in the last 30 days cost 5 instead of 15.
| Parameter | Type | Default | Limits |
|---|---|---|---|
actionrequired | "discovery" | "analysis" | | |
platform | "instagram" | "youtube" | "tiktok" | "instagram" | |
handles | string[] | | 1–50 items |
analysis_id | string | | 1–100 chars |
workspace_id | string | | 1–100 chars |
get_credit_history
get_credit_historyread-onlyRecent credit charges, refunds and top-ups for the workspace.
| Parameter | Type | Default | Limits |
|---|---|---|---|
limit | integer | 20 | 1–100 |
workspace_id | string | | 1–100 chars |
get_topup_link
get_topup_linkwriteA Stripe checkout link for the HUMAN user to buy credits. Agents cannot pay: give the user the URL.
| Parameter | Type | Default | Limits |
|---|---|---|---|
package_id | "starter" | "growth" | "scale" | "starter" | |
workspace_id | string | | 1–100 chars |