Tools
Tools overview
47 tools are exposed — 32 read-only and 15 that write.
This list is generated from the registry, so it matches what tools/list returns exactly.
An MCP tools/call envelope is { "name": "<tool>", "arguments": { … } }; arguments may be
omitted or null (treated as {}). Every tool's inputSchema sets additionalProperties: false.
Over REST, the same tool is POST /api/v1/tools/{name} with the arguments as the JSON body.
Read tools (32)
- Discovery & context —
get_data_coverage,get_metric_definitions,get_context_pack - Paid ads & creative —
get_performance_summary,get_daily_performance,get_accounts_performance,get_campaigns_performance,get_adsets_performance,get_ads_performance,get_keywords_performance,get_geo_performance,get_creative_fatigue,get_creative_leaderboard - Channels, web, email & organic —
get_channels,get_ga4,get_email,get_organic - Forecast, CAC, finance & modeling —
get_forecast,get_signal_cac,get_finance,get_mmm_results,run_report - Change sets & audiences —
list_management_connections,list_change_sets,get_change_set,list_audiences - Signal —
signal_page_rule_list,signal_form_group_list,signal_attribution_model_list,signal_sessions_list,signal_session_get,signal_session_playback_grant
Write tools (15)
- Change sets —
changes_draft,changes_add_item,changes_submit - Audiences —
audience_create,audience_update_filters,audience_add_destination - Account & organization settings —
account_update,org_update_digest_settings - Signal configuration & sessions —
signal_page_rule_upsert,signal_page_rule_delete,signal_form_group_upsert,signal_attribution_model_upsert,signal_destination_update_config,signal_session_delete,signal_session_enqueue_analysis
All tools
| Tool | Posture | Module gate | Purpose |
|---|---|---|---|
get_data_coverage | read-only | — | Data coverage |
get_metric_definitions | read-only | — | Metric definitions |
get_context_pack | read-only | — | Context pack |
get_performance_summary | read-only | ads | Ad performance summary |
get_daily_performance | read-only | ads | Daily ad performance |
get_accounts_performance | read-only | ads | Performance by ad account |
get_campaigns_performance | read-only | ads | Performance by campaign |
get_adsets_performance | read-only | ads | Performance by ad set |
get_ads_performance | read-only | ads | Performance by ad |
get_keywords_performance | read-only | ads | Performance by keyword |
get_geo_performance | read-only | ads | Performance by geography |
get_creative_fatigue | read-only | ads | Fatigued ads |
get_creative_leaderboard | read-only | creative | Creative leaderboard |
get_channels | read-only | channels | All channels |
get_ga4 | read-only | ga4 | GA4 web analytics |
get_email | read-only | email | Email marketing |
get_organic | read-only | organic | Organic social |
get_forecast | read-only | forecast | Performance forecast |
get_signal_cac | read-only | signal_cac | Signal CAC by channel |
get_finance | read-only | finance | Financials (books) |
get_mmm_results | read-only | compass | Marketing mix model results |
run_report | read-only | — | Run a report template |
list_management_connections | read-only | — | List management connections |
changes_draft | mutates state | — | Draft a change set |
changes_add_item | mutates state | — | Add an item to a change set |
changes_submit | mutates state | — | Submit a change set for review |
list_change_sets | read-only | — | List change sets |
get_change_set | read-only | — | Get a change set |
list_audiences | read-only | — | List audiences |
audience_create | mutates state | — | Create an audience |
audience_update_filters | mutates state | — | Update audience filters |
audience_add_destination | mutates state | — | Add an audience destination |
account_update | mutates state | — | Rename or hide an ad account |
org_update_digest_settings | mutates state | — | Update Slack digest settings |
signal_page_rule_list | read-only | — | List conversion page rules |
signal_page_rule_upsert | mutates state | — | Create or update a conversion page rule |
signal_page_rule_delete | mutates state | — | Delete a conversion page rule |
signal_form_group_list | read-only | — | List form groups |
signal_form_group_upsert | mutates state | — | Create or update a form group |
signal_attribution_model_list | read-only | — | List attribution models |
signal_attribution_model_upsert | mutates state | — | Create or update an attribution model |
signal_destination_update_config | mutates state | — | Update a conversions destination's config |
signal_sessions_list | read-only | — | List Signal sessions |
signal_session_get | read-only | — | Get Signal session |
signal_session_playback_grant | read-only | — | Grant Signal session playback URLs |
signal_session_delete | mutates state | — | Delete Signal session recording |
signal_session_enqueue_analysis | mutates state | — | Enqueue Signal session analysis |
Write tools are human-in-the-loop
The write tools are deliberately incapable of finishing a change on their own. An agent can draft a change set, add items to it and submit it — a human still approves it in the app, and approval is not exposed here. An agent can create an audience and attach a destination, but cannot push, export or delete one. Configuration tools reach cosmetic and notification settings only; credential and mapping fields are not representable in any schema on this surface.
Last modified on