Business & Operations

AdsAgent

by Adsagents LLC

Overview

AdsAgent helps advertising operators inspect Meta performance, manage reusable launch templates, prepare campaign changes, and execute explicitly confirmed Meta advertising actions through ChatGPT. OAuth connects to the operator's own AdsAgent workspace; advertising delivery changes require explicit confirmation, and workspace templates and settings can be edited directly at the user's request. AdsAgent never asks for health, payment-card, government-ID, or biometric data.

Tools

account_get_profile

ChatGPT

account_media_get

ChatGPT

Read one account media reference; prefer account_media_get_batch for multiple selections

account_media_get_batch

ChatGPT

Fetch up to 50 selected account media previews in a batch after listing the index; avoid serial item probes

account_media_list

ChatGPT

List 50 account media index entries; select candidates, then use account_media_get_batch. Check setup_get_status policy

accounts_get_account_detail

ChatGPT

Read live Meta details for one ad account authorized in your workspace; app bindings are cached, no BM links. BM topology: assets_lookup_business_links

accounts_list_eligible_pages

ChatGPT

List pages eligible for ad creation on one ad account (snapshot read)

accounts_list_instagram_accounts

ChatGPT

List IG IDs

accounts_list_linked_accounts

ChatGPT

Read linked Meta ad accounts and their Facebook connection labels from stored workspace routing. Filter then paginate. refresh rereads stored rows; this tool does not sync Meta, queue work, or save snapshots. BM links: assets_lookup_business_links

ads_get_copy

ChatGPT

Read stored copy of 1-50 ads: texts, links, button, Page, preview, type

ads_prepare_status_change

ChatGPT

Prepare one ad status change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_ad_status. This call does not change delivery

ads_replace_creative_confirm

ChatGPT

Confirm an approved in-place creative swap

ads_replace_creative_deny

ChatGPT

Deny a prepared in-place creative swap

ads_replace_creative_prepare

ChatGPT

Prepare in-place library-creative swap on an existing ad

ads_replace_page_confirm

ChatGPT

Confirm an approved in-place page swap

ads_replace_page_deny

ChatGPT

Deny a prepared in-place page swap

ads_replace_page_prepare

ChatGPT

Prepare page swap; may upload media to Meta. Confirm separately to apply

ads_update_copy_confirm

ChatGPT

Confirm approved copy edits; read back copy on the same Ad ID

ads_update_copy_deny

ChatGPT

Discard prepared copy edits without changing the ad

ads_update_copy_prepare

ChatGPT

Prepare body/title/description edits on the same Ad ID, preserving media and Page

ads_update_url_prepare

ChatGPT

Prepare a destination URL change on the same Ad ID; confirm/deny via operations

adsets_prepare_bid_change

ChatGPT

Prepare one ad set bid-amount change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_adset_bid. This call does not change delivery

adsets_prepare_budget_change

ChatGPT

Prepare one ad set daily-budget change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_adset_budget. This call does not change delivery

adsets_prepare_status_change

ChatGPT

Prepare one ad set status change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_adset_status. This call does not change delivery

assets_list_ad_accounts

ChatGPT

List Meta ad accounts this workspace can use, with routing flags. Cache miss/authorized refresh may queue private work; filter then paginate; assets_lookup_business_links

assets_list_businesses

ChatGPT

List Meta Business Managers visible to this workspace. Cache miss/authorized refresh may queue private work; filter then paginate; assets_lookup_business_links

assets_list_instagram_accounts

ChatGPT

List cached Instagram IDs and names from Auto Pull Assets

assets_list_pages

ChatGPT

List Facebook Pages this workspace can advertise with, with health. Cache miss/authorized refresh may queue private work; filter then paginate; assets_lookup_business_links

assets_lookup_business_links

ChatGPT

Read cached BM links. Choose exactly one: business_id, ad_account_id, page_id, or FB-user identity such as fb_user_label; never combine an asset ID with an FB user. Snapshot edges may be incomplete; no match does not prove no relationship or ownership. OAuth-safe

assets_pick

ChatGPT

Choose one cached ad account, Facebook Page or Instagram account

assets_refresh_ad_account

ChatGPT

Refresh one account and its connection Page cache

assets_search_mentions

ChatGPT

Search the caller's ad accounts, products and campaigns for composer @-mentions

billing_get_usage

ChatGPT

Read plan and measured usage (free during the public beta)

campaigns_prepare_budget_change

ChatGPT

Prepare one campaign daily-budget change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_campaign_budget. This call does not change delivery

campaigns_prepare_budget_changes

ChatGPT

Prepare 1-10 campaign daily-budget changes: read current Meta budgets and save one approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_campaign_budgets. This call does not change delivery

campaigns_prepare_status_change

ChatGPT

Prepare one campaign status change: read current Meta settings in your authorized account and save an approval draft. Returns approval_ref and plan_digest; apply only after approval with operations_confirm_campaign_status. This call does not change delivery

campaigns_quick_create

ChatGPT

Prepare new ads or append to an existing campaign/ad set using request.ad_account_id, a saved template, and one creative_source. Choose append_mode and target IDs explicitly. Use copy_ad_quick_copy for live-ad copies. Review the draft; launch_confirm executes after approval Use the workflow's original link_id when exposed.

campaigns_reconcile_campaign_plan

ChatGPT

Reconcile fixed existing-Ad campaign plans before prepare

campaigns_recreate_from_task

ChatGPT

Prepare recreate from a prior create task Use the workflow's original link_id when exposed.

connections_check_intent

ChatGPT

Check one existing authorization handle after the user finishes: intent_id accepts ci_, Meta connect_id or fbconn_live_ handles. Returns status/channel or not_found_or_expired. Reuse the link while valid; do not start automatic polling. For setup connect_id use setup_check_channel_connect

connections_create_intent

ChatGPT

Create a single-use browser authorization link for channel=meta|google_ads|tiktok and mode=add_connection; returns connect_url for human authorization. Prefer setup_begin_channel_connect when you need its explicit connect_id/check workflow

connections_disconnect_guide

ChatGPT

Facebook link and steps for the user to remove AdsAgent's access

connections_list

ChatGPT

List redacted platform connections

console_export_csv

ChatGPT

Export stored Console metrics as CSV

console_get_stored_entity_evidence

ChatGPT

Read stored entity configuration evidence

console_prepare_change

ChatGPT

Prepare a Console delivery change for approval

console_query_overview

ChatGPT

Read a stored dashboard page in USD

copy_ad_clone_structure

ChatGPT

Prepare a same-account 1:1 campaign/ad-set tree clone, keeping each ad's creative. Pass ad_account_id and exactly one source_campaign_id or source_adset_id; copies=1-10. paused is default; inherit may resume spend. Use copy_ad_quick_copy to expand selected ads. Review exclusions, then launch_confirm after approval Use the workflow's original link_id when exposed.

copy_ad_quick_copy

ChatGPT

Prepare copies of live ads: request_mode=single uses ad_id, source_ad_account_id and target_ad_account_id; grouped uses grouped_plan.campaigns. v3 requires explicit statuses. Choose preserve_post/new_creatives; partnership preserves the post. For a whole tree use copy_ad_clone_structure. Review, then launch_confirm Use the workflow's original link_id when exposed.

creatives_cloud_status

ChatGPT

Read Drive binding status; follow next_action

creatives_get

ChatGPT

Get one owned creative by selection_key: details plus signed download and thumbnail links

creatives_get_batch

ChatGPT

Get 1-50 owned creatives by selection_key: per-item status, details and signed links

creatives_list

ChatGPT

List owned creatives; default is the whole library. For upload/how-to help, give Creative library: choose a folder, Upload images/videos, then search by filename. Use the same AdsAgent account. No list call is needed just for instructions. For reads, trust scope, use limit<=50 and follow next_cursor with unchanged filters

creatives_list_cloud

ChatGPT

List Drive files from the local index

creatives_list_folders

ChatGPT

List creative folders

creatives_pick

ChatGPT

Choose creatives from the caller's library, newest first

creatives_refresh_cloud

ChatGPT

Re-list the bound Drive folder (60s cooldown)

entities_prepare_update

ChatGPT

Prepare one approval to change status, name, budget, bid, schedule, spend cap, targeting or frequency of 1-10 campaigns,

fb_users_list

ChatGPT

Read stored FB labels/status/expiry/routing, never credentials; filter then paginate. refresh rereads rows; no Meta sync, token refresh, queued work or snapshot writes. BM: assets_lookup_business_links. Access is not full Settings. Use the same AdsAgent account

fb_users_update_label

ChatGPT

Set the display label for one FB user connection

insights_export_csv

ChatGPT

Export or queue CSV for one bounded scope

insights_get_date_range

ChatGPT

Read stored Insights date coverage

insights_pull_product_breakdowns

ChatGPT

Fetch country, placement, age, gender, OS, or hourly Meta metrics for selected products and dates. Uses stored coverage or queues a bounded pull and returns task_ref; poll tasks_get_status, then read each dimension with insights_read_breakdowns. New pulls consume the existing daily quota without changing ad delivery

insights_query_batch_overview

ChatGPT

Cached batch: each needs product_ref/product_name/ad_account_id; group_by, YYYY-MM-DD date_from/date_to; page for all. Partial=unknown, never zero. Use advertised insights_query_consistent

insights_query_consistent

ChatGPT

Read your authorized product/account scope or batch. For query_contract_version=1 supply group_by, dates and scope/scopes via request OR direct fields. cached reads stored data; fresh modes may queue Meta pulls for those accounts and save results. Poll task_ref without duplicate refreshes. Check complete and coverage; never infer zero from partial data

insights_query_overview

ChatGPT

Read stored aggregated insights for one product/account and YYYY-MM-DD date_from/date_to; group_by=account/campaign/adset/ad. No refresh. Check completeness and paginate while has_more. Use insights_query_batch_overview for many scopes, or insights_query_consistent when the agent-method profile is advertised

insights_read_breakdowns

ChatGPT

Read country, placement, age, gender, OS, or hourly Meta metrics for one product_ref or product_name and date window. Returns stored rows and full-scope totals; a cache miss may queue a bounded pull and return task_ref. Poll tasks_get_status, then repeat the read with identical filters. Automatic pulls use the existing daily quota; ad delivery is unchanged

interests_archive

ChatGPT

Archive one saved audience pack by its exact public name

interests_fetch_from_adset

ChatGPT

Preview a reusable audience pack from one live Meta ad set

interests_get

ChatGPT

Read an audience pack by exact name

interests_keep_draft

ChatGPT

Keep a launch draft as an audience pack

interests_list

ChatGPT

List saved audience packs

interests_save_fetched_pack

ChatGPT

Read targeting from one Ad Set in your authorized Meta accounts and save a reusable audience pack in your private AdsAgent workspace

interests_save_targets

ChatGPT

Save targeting_search picks as an audience pack

interests_search

ChatGPT

Search Meta interest IDs by keyword; limit up to 25

interests_use_targets

ChatGPT

Create or reuse a temporary audience-targeting draft in AdsAgent from targeting_search picks and return its interest_pack_name. Does not create, publish, or modify Meta ads. Unkept drafts expire after 7 days; this call may delete expired drafts

launch_confirm

ChatGPT

Approved QuickCreate/copy/recreate/clone: exact single-use confirm_token; never rewrite or replay. Lost token: operations_get_approval; follow its next_action. Replies: results, not approval handles/JSON/debug.

launch_deny

ChatGPT

Discard a prepared QuickCreate, recreate, ad-copy or structural-clone draft using its exact confirm_token. No Meta write. For a lost token, use operations_get_approval then operations_deny_approval with approval_ref and expected_plan_digest

mmp_get_state

ChatGPT

Read MMP mapping, cohort, and funnel state

mmp_insights_get_product_event_today

ChatGPT

Read today's events; channel_pid required

mmp_insights_get_product_today

ChatGPT

Read today's D0 cohort; channel_pid required

mmp_insights_query_product_cohort

ChatGPT

Read cohorts; channel_pid required

mmp_insights_query_product_event_summary

ChatGPT

Read event totals; channel_pid required

notifications_ack

ChatGPT

Acknowledge one TaskTools notification

notifications_list

ChatGPT

List TaskTools notifications

notifications_resolve

ChatGPT

Resolve one TaskTools notification

notifications_scan

ChatGPT

Refresh alerts; may notify configured channels

notifications_summary

ChatGPT

Read notification lifecycle counts and the push events a client can subscribe to (events/subscribe)

open_ads_console

ChatGPT

Open the product Insights dashboard

operations_confirm_ad_copy

ChatGPT

After explicit user approval, queue the approved copy of a Meta ad. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_copy_update

ChatGPT

After explicit user approval, replace the title, body, or description on one existing Meta ad. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_creative_replace

ChatGPT

After explicit user approval, replace the creative on one existing Meta ad. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_grouped_copy

ChatGPT

After explicit user approval, queue the approved grouped batch of Meta ad copies. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_page_replace

ChatGPT

After explicit user approval, replace the Facebook Page identity on one existing Meta ad. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_status

ChatGPT

After explicit user approval, change delivery status of one Meta ad. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_statuses

ChatGPT

After explicit user approval, change delivery status for the approved batch of Meta ads. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_ad_url_update

ChatGPT

After explicit user approval, replace the destination URL on one existing Meta ad. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_adset_bid

ChatGPT

After explicit user approval, replace the bid amount of one Meta ad set. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_adset_budget

ChatGPT

After explicit user approval, replace the daily budget of one Meta ad set. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_adset_status

ChatGPT

After explicit user approval, change delivery status of one Meta ad set. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_campaign_budget

ChatGPT

After explicit user approval, replace the daily budget of one Meta campaign. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_campaign_budgets

ChatGPT

After explicit user approval, replace daily budgets for the approved batch of Meta campaigns. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_campaign_create

ChatGPT

After explicit user approval, queue creation of the approved Meta campaign, ad set, and ad structure. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_campaign_recreate

ChatGPT

After explicit user approval, queue recreation of the approved Meta campaign structure from a prior task. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_campaign_status

ChatGPT

After explicit user approval, change delivery status of one Meta campaign. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_entity_update

ChatGPT

Confirm the approved plan to apply the approved Meta entity changes. Requires approval_ref and expected_plan_digest. Batch approvals also require the complete expected_changes, including excluded rows

operations_confirm_product_delivery_pause

ChatGPT

After explicit user approval, pause the approved product family campaigns in Meta. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_confirm_structure_clone

ChatGPT

After explicit user approval, queue cloning of the approved Meta campaign or ad set structure. Uses only the stored plan selected by approval_ref and expected_plan_digest; rejects other operation kinds before reserving or applying anything. Changes external Meta advertising state and may affect spend

operations_deny_approval

ChatGPT

Deny a prepared operation by approval_ref and expected_plan_digest from operations_get_approval. Invalidates that draft without applying it; rejects a stale digest. No Meta write. Works across supported approval types

operations_get

ChatGPT

Read a mutation receipt by mutation_ref or creative upload receipt by upload_ref

operations_get_approval

ChatGPT

Read a mutation approval by approval_ref Use the workflow's original link_id when exposed.

operations_get_context

ChatGPT

Recover mutation, task, approval, and policy context Use the workflow's original link_id when exposed.

overview_get_live_configs

ChatGPT

Read current Meta status, budget, bid, and other settings for up to 50 known campaigns, ad sets, or ads in your authorized accounts. With mutation_ref, also save verification of that operation in AdsAgent using its original writer. Does not change ads or delivery

overview_update_ad_statuses

ChatGPT

Prepare 1-10 ad configured-status changes in OAuth Safe Mode. Each item needs ad_id, ad_account_id and target_configured_status=ACTIVE|PAUSED. Configured ACTIVE does not prove delivery: a parent may be paused. Review current/new values, then overview_update_confirm after approval

overview_update_confirm

ChatGPT

Approved status/budget/bid: exact bu_confirm_ or mu_confirm_ from prepare. Single-use; stop at first failed or uncertain item. Replies: results, not approval handles/JSON/debug.

overview_update_deny

ChatGPT

Discard a prepared status, campaign/ad-set budget or bid update with its exact bu_confirm_ or mu_confirm_ token. No Meta write. Use launch_deny for creation/copy drafts and products_delivery_pause_deny for product-family pauses

products_delivery_pause_confirm

ChatGPT

After user approval, pause product-family delivery with exact pd_confirm_* from products_delivery_pause_prepare. Single-use; never replay. Replies: results, not approval handles/JSON/debug.

products_delivery_pause_deny

ChatGPT

Discard a product-family pause draft using the exact pd_confirm_* token from products_delivery_pause_prepare. No Meta write. Use overview_update_deny for individual status/budget/bid drafts and launch_deny for creation/copy drafts

products_delivery_pause_prepare

ChatGPT

Prepare a pause of live-verifiable ACTIVE campaigns for 1-20 owned product_refs in your authorized Meta accounts; expected_scope=all_live_active_campaigns. Saves an approval draft. Review excluded inventory and budget drift. Prepare does not pause Meta. After approval pass its pd_confirm_* token to products_delivery_pause_confirm

products_get_actions

ChatGPT

Read Meta actions for funnel setup

products_get_funnel_candidates

ChatGPT

List ordered funnel-step candidates with 7-day and 30-day counts

products_get_funnel_values

ChatGPT

Read per-ad funnel values

products_get_health

ChatGPT

Read cached product delivery and connection status

products_get_top_campaigns

ChatGPT

Read top campaigns by spend

products_list

ChatGPT

List products and funnel/MMP event sources

products_save_funnel_events

ChatGPT

Save the ordered funnel-event choices for one product

products_save_timezone_offset

ChatGPT

Save one product's POSIX timezone offset

render_ad_previews

ChatGPT

Show ads as preview cards

render_ads_console

ChatGPT

Show an interactive ads console

render_performance_report

ChatGPT

Show fetched performance rows as a report

setup_begin_channel_connect

ChatGPT

Create a private expiring authorization ticket/receipt. User consents in browser at authorize_url; no binding, replacement or ad changes. After user confirmation, setup_check_channel_connect once with connect_id; no auto-poll

setup_begin_facebook_connect

ChatGPT

Create a Facebook authorization link

setup_check_channel_connect

ChatGPT

After the user confirms authorization is finished, check once using channel=meta|google_ads|tiktok and the exact connect_id from setup_begin_channel_connect. Do not poll automatically while the link remains valid; use setup_get_status for workspace readiness

setup_check_facebook_connect

ChatGPT

Check Facebook auth and first sync

setup_get_settings

ChatGPT

Read background refresh settings with their schema and layout

setup_get_status

ChatGPT

Read readiness for user-requested ad setup or explicit connection/readiness diagnosis. For unrelated tasks, skip AdsAgent tools. For requests to reveal/export private credentials (passwords, [secret-redacted], MFA codes), refuse without tools. Do not run setup to offer alternatives. Connection-health, expiry and reauthorization checks remain supported

setup_readiness_check

ChatGPT

Read minimal launch readiness

setup_update_settings

ChatGPT

Change background refresh settings; pass only changed values in set

support_get_report_status

ChatGPT

Read a support report status

support_report_error

ChatGPT

Save a report for your owned support_ref in the private AdsAgent support queue. Accepts bounded error classifications, no external recipient. Does not retry or change an advertising operation

targeting_search

ChatGPT

Search Meta targeting IDs by type and keyword

tasks_cancel

ChatGPT

Cancel a pending tenant-owned task or stop its remaining ordinary Insights recovery while preserving terminal history

tasks_get_create_detail

ChatGPT

Read your create/copy task's saved ad copy and failures. include_live also reads targeting for that task's ad sets in your authorized Meta accounts; it does not rerun the task or change ads

tasks_get_status

ChatGPT

Poll task_ref; never retry unchanged writes Use the workflow's original link_id when exposed.

tasks_latest

ChatGPT

Read latest completed task summary

tasks_list

ChatGPT

List recent task summaries

tasks_list_create_history

ChatGPT

List recent create/copy history

templates_create

ChatGPT

Create a saved launch template

templates_delete

ChatGPT

Delete a template by name or public reference

templates_get

ChatGPT

Read a template by exact name

templates_list

ChatGPT

List saved templates

templates_reverse_engineer

ChatGPT

Read one Ad or Ad Set in your authorized Meta accounts and return an unsaved template preview. Does not save templates or change ads

templates_update

ChatGPT

Update an owned saved template immediately using request.template_name and flat update fields. Use new_template_name to rename or creative_distribution to change creative allocation. With no configuration maps, one source_ad_id or source_adset_id imports a fresh snapshot. Read back by exact template_name; this does not update running ads

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Links

Documentation ↗Privacy Policy ↗

App Stats

152

Tools

Prompts

ChatGPT

Platforms