Calling tools
Use an MCP client with OAuth authorization. The JSON examples are argument objects for named tools. They are not standalone HTTP bodies. A parameter namedpayload, request, data, family, or content must keep that nesting.
Read tools require mcp:read. Write tools also require mcp:write and the relevant workspace, account, and functional permissions.
Argument examples show valid input shapes for common tasks. See IDs and retries before issuing writes.
Accounts, assets, and brands
| Tool | Access | Purpose |
|---|---|---|
ad_accounts_list | Read | List ad accounts the current user may read. |
ad_accounts_get | Read | Read one authorized ad account. |
brands_list | Read | List brands the current user may read. |
brands_create | Write | Create a brand profile and grant its creator write access. |
brands_update | Write | Update selected profile or brand-kit fields. |
brands_get | Read | Read one authorized brand with its active structured brand kit. |
assets_list | Read | List a page of campaigns, ad sets, ads, or creatives for an account. |
assets_get | Read | Read one campaign, ad set, ad, or creative from the imported account data. |
Insights tools
| Tool | Access | Purpose |
|---|---|---|
insights_capabilities | Read | List supported metrics, reporting levels, breakdowns, and pagination settings. |
insights_query | Read | Read one page of reporting data. |
insights_rank | Read | Rank performance over a date range. |
Rule tools
| Tool | Access | Purpose |
|---|---|---|
rules_schema | Read | List the metrics, conditions, actions, and fields supported by the rule builder. |
rules_list | Read | List rules for which you can read all target accounts. |
rules_get | Read | Read a rule and its current version before editing it. |
rules_create | Write | Create a rule for accounts where you have the required permissions. |
rules_update | Write | Replace one rule; first read it and preserve every unchanged field. |
rules_change_status | Write | Set a rule to draft, active, or paused using its current version. |
rules_delete | Write | Archive one authorized rule. |
rules_changes | Read | Read the saved change history for a rule. |
rules_run | Write | Submit a rule run and return its ID for tracking. |
rule_runs_list | Read | List authorized rule runs. |
rule_runs_get | Read | Read one authorized rule run. |
rule_activity_list | Read | List authorized rule activity records. |
rule_activity_get | Read | Read one authorized rule activity record. |
rule_activity_summary | Read | Summarize activity for one rule. |
Direct Meta actions
| Tool | Access | Purpose |
|---|---|---|
actions_capabilities | Read | Check which Meta actions and live changes are enabled. |
media_uploads_create | Write | Open a media picker or prepare a signed upload to the workspace library. |
media_uploads_complete | Write | Upload one to ten selected files and return a result for each file. |
creatives_create | Write | Create a Meta creative from one completed signed media upload. |
campaigns_create | Write | Validate campaign inputs or create a paused Meta campaign. |
adsets_create | Write | Validate ad-set inputs or create a paused Meta ad set. |
ads_create | Write | Validate ad inputs or create a paused Meta ad. |
actions_execute | Write | Change the status of a campaign, ad set, or ad with set_status. |
campaigns_duplicate | Write | Preview or copy a campaign with its children in the same account, paused. |
adsets_duplicate | Write | Preview or copy an ad set with its ads in the same campaign, paused. |
ads_duplicate | Write | Preview or copy an ad in the same ad set, paused. |
actions_get | Read | Read an action result using its activity ID. |
Activity tools
| Tool | Access | Purpose |
|---|---|---|
activity_list | Read | Search tool calls, actions, and rule runs. |
activity_get | Read | Read one complete authorized activity record by ID. |
activity_summary | Read | Count the complete authorized result set for activity filters. |
Memory tools
| Tool | Access | Purpose |
|---|---|---|
memory_remember | Write | Save a fact after the user asks you to remember it or approves a specific suggestion to save it. |
memory_recall | Read | Find saved facts relevant to a query. |
memory_get | Read | Read one exact authorized memory by ID. |
memory_list | Read | List one memory page with an optional scope filter. |
memory_update | Write | Replace a saved fact using its current version. |
memory_set_enabled | Write | Enable or disable a saved fact for future retrieval. |
memory_forget | Write | Permanently delete a saved fact after user approval. |
Launcher library tools
| Tool | Access | Purpose |
|---|---|---|
launcher_discover | Read | Check available Launcher tools, permissions, limits, and upload instructions. |
launcher_creatives_list | Read | List or search active creatives in the workspace library. |
launcher_creatives_usage | Read | Find where a creative has been selected or used in an account. |
launcher_creatives_get | Read | Read a creative and its saved version summaries. |
launcher_creative_versions_get | Read | Read the copy and media for one saved version. |
launcher_creatives_create | Write | Create a library creative with its first draft version. |
launcher_creatives_update | Write | Edit a creative’s name, concept, or tags using its current lock version. |
launcher_creatives_archive | Write | Archive a creative while retaining its content versions and launch history. |
launcher_creative_versions_create | Write | Save new content as a draft version. |
launcher_creative_versions_approve | Write | Approve one complete creative version, including its language variants. |
launcher_creative_versions_revoke | Write | Revoke approval for a complete creative version and record the reason. |
launcher_collections_list | Read | List fixed and smart collections in the workspace. |
launcher_collections_preview | Read | Preview which creatives match an unsaved smart filter. |
launcher_collections_get | Read | Read a collection and its current revision. |
launcher_collections_create | Write | Create a fixed selection of creatives or a smart collection with filters and exclusions. |
launcher_collections_update | Write | Replace a collection definition and its members using the current lock version. |
launcher_collections_archive | Write | Archive a collection. |
launcher_collections_resolve | Read | Select creatives from a collection for launch preparation. |
launcher_templates_list | Read | List active templates within the authorized workspace. |
launcher_templates_get | Read | Read a template and its saved settings versions. |
launcher_templates_create | Write | Save a template and its first settings version. |
launcher_template_versions_create | Write | Save new template settings as a separate version. |
launcher_templates_archive | Write | Archive a template while retaining versions used by earlier launches and schedules. |
launcher_media_list | Read | List saved media and its IDs. |
launcher_media_get | Read | Read saved media details. |
launcher_media_delete | Write | Archive unused media and queue file deletion. |
launcher_media_retry_thumbnail | Write | Request another thumbnail-generation attempt for a saved media item. |
Launcher launch tools
| Tool | Access | Purpose |
|---|---|---|
launcher_promotion_sources_list | Read | Find ads created by earlier tests that are available for promotion. |
launcher_assets_list | Read | Find Meta Pages, Instagram accounts, pixels, audiences, and other assets by name. |
launcher_targets_list | Read | List current ad sets for the account. |
launcher_targets_get | Read | Read an ad set’s account, parent campaign, current settings, and validation fingerprint. |
launcher_launches_preview | Read | Check approved content, planned Meta objects, and estimated usage. |
launcher_launches_submit | Write | Submit a launch with one stable request_key, then track its result. |
launcher_launches_list | Read | List launches with the newest first. |
launcher_launches_get | Read | Read launch status and links to the operation results. |
launcher_launches_change_status | Write | Hold or resume an unstarted run; a missed time requires Run now or a new time. |
launcher_launches_cancel | Write | Request cancellation of a launch. |
launcher_launches_replacement_candidates | Read | Find failed items eligible for replacement with corrected content. |
launcher_run_operations | Read | Read the result and attempt history of each launch operation. |
launcher_launches_retry | Write | Retry eligible failed operations with their original inputs. |
Launcher schedules and limits
| Tool | Access | Purpose |
|---|---|---|
launcher_schedules_create | Write | Create a recurring launch with saved template and selection settings. |
launcher_schedules_change_status | Write | Pause or resume future scheduled runs. |
launcher_schedules_list | Read | List recurring launches for an account. |
launcher_schedules_get | Read | Read a schedule definition and exact version references. |
launcher_schedules_update | Write | Update settings for future runs. |
launcher_account_limits_get | Read | Read the account’s Launcher campaign-count and configured-budget limits. |
launcher_account_limits_update | Write | Set the account’s Launcher limits. |
Launcher Drive tools
| Tool | Access | Purpose |
|---|---|---|
launcher_drive_folders_list | Read | List saved workspace folders. |
launcher_drive_folders_save | Write | Save a folder selected in Superlaunch’s Google Picker. |
launcher_drive_folder_files_list | Read | List up to 100 files and folders that you selected through Google Picker. |