To let an assistant use these tools, grant Organisation on the consent screen, or just
Usage & spend under its Fine-tune. The scope is usage.
Read tools work with Read only or Read & write access; write tools only with
Read & write.
Your assistant doesn't see these tools straight away. It finds them with search_tools or
describe_tools, and runs one with use_tool, passing its name and
arguments. Most assistants do this for you: just ask for what you want.
What your assistant is told about this group
What your organisation has spent on Subcontext's metered services, in pence at the prices you're charged: AI, SMS, WhatsApp, email, voice and phone numbers, by purpose, agent, day, conversation and outreach stream, plus this month so far against your plan's allowances. Read-only; needs a manager or owner. Your balance and invoices are in the subscription group.
The descriptions below are the ones your assistant reads, so they're written for it. When a connection covers more than one
organisation, the assistant passes org (the organisation's slug, from list_orgs) to say which one.
get_usage_summary
Read Get usage and spend
The org's metered spend for a window, in GBP pence charged: AI (by purpose and by agent, calls and tokens), SMS, WhatsApp, email, voice and phone numbers, spend by day, calls refused by the budget cap, and month-to-date spend against each plan allowance with any overage. Manager or owner.
Arguments
| Field | Type | Description |
|---|---|---|
| period | string |
Default last30; "" is all time; custom needs from/to (YYYY-MM-DD).
One of: "today", "yesterday", "week", "last_week", "last7", "month", "last_month", "last30", "last90", "custom", ""
|
| from | string | |
| to | string | |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_insights_costs
Read Get what the business spent against what it got
For a window against the one before, as on Insights > Costs: AI and messaging usage at retail, ad spend synced from Google Ads and Meta, lead prices, campaign costs entered by hand, commission clawed back on cancelled sales (clawbacks), the total, the leads and goal conversions it bought, and the cost per lead and per conversion; plus AI and messaging spend by channel and AI spend by agent. Money in pence. Owners and managers. period: today, week, month (so far), last7, last30 (default), last90, last_month, or custom with from/to.
Arguments
| Field | Type | Description |
|---|---|---|
| period | string |
One of: "today", "week", "month", "last7", "last30", "last90", "last_month", "custom"
|
| from | string | |
| to | string | |
| goal | string | A goal key (get_outcome_model); the org's default when omitted. |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
list_costly_conversations
Read List conversations by cost
Every conversation that spent anything in the window, dearest first (up to 100; capped: true when there are more). Manager or owner.
Arguments
| Field | Type | Description |
|---|---|---|
| period | string |
Default last30; "" is all time; custom needs from/to (YYYY-MM-DD).
One of: "today", "yesterday", "week", "last_week", "last7", "month", "last_month", "last30", "last90", "custom", ""
|
| from | string | |
| to | string | |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_conversation_costs
Read Get one conversation's costs
What a conversation cost: AI work by purpose, and messages or minutes by kind. Manager or owner.
Arguments
| Field | Type | Description |
|---|---|---|
| conversation_id required | string | |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_outreach_stream_costs
Read Get an outreach stream's costs
What an outreach stream spent in the window: by day (AI drafting and message sends) and by conversation it opened. Manager or owner.
Arguments
| Field | Type | Description |
|---|---|---|
| stream_id required | string | |
| period | string |
Default last30; "" is all time; custom needs from/to (YYYY-MM-DD).
One of: "today", "yesterday", "week", "last_week", "last7", "month", "last_month", "last30", "last90", "custom", ""
|
| from | string | |
| to | string | |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |