Tool catalog
What this endpoint advertises
This endpoint currently advertises 67 public tools: 39 read-only and 28 write-capable. Advertised capabilities and your entitled access are separate. Access depends on your plan, connected accounts and permissions.
Each tool carries one permission class. Read tools change nothing. Sensitive write tools (28 of them) change ad spend or delivery, send a message, change settings or connections, or switch the working account (some platforms limit or lock those changes). We document them for per-call approval: an assistant that supports it, such as Muse, should ask you before each one. Combined tools are classed by their strictest action.
Search and filter are optional. Every tool stays listed below.
Other tools and workflows
58 tools · 32 read · 26 write
-
Setup · PlatformRead
connect_platform_toolStarts the connection flow for an advertising or analytics platform (Google Ads, Meta, GA4, Google Tag Manager, Search Console, TikTok, LinkedIn, Microsoft Advertising, Pinterest, X, YouTube) and returns the authorization link.
-
Cross-platform · List all accountsRead
list_all_accounts_toolLists every advertising and analytics account reachable across all connected platforms: Google Ads, Meta (Facebook and Instagram), GA4, Search Console, Merchant Center, TikTok, LinkedIn, Microsoft Advertising (Bing), Pinterest, X (Twitter) and YouTube.
-
System · Health checkRead
health_check_toolChecks that AdvisorPPC and each connected advertising and analytics platform are responding, and reports any provider that is failing or degraded.
-
Get connector contextRead
get_connector_contextReports the current AdvisorPPC plan, which advertising and analytics providers are connected, and where to manage billing.
-
How to connect AdvisorPPC to each AI hostRead
connector_help_toolExplains how to add the AdvisorPPC connector to the app you are using, with the endpoint for each supported client (ChatGPT, Grok, Cursor, Gemini CLI and the desktop apps) and which tools that client sees.
-
TikTok Ads · Create campaignSensitive write
tt_create_campaign_toolTikTok Ads: create a campaign with auto-paused status. budget is a plain amount in the account currency, not cents: 50 means $50/day on a USD account. TikTok's daily minimum is 50. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Create ad groupSensitive write
tt_create_ad_group_toolTikTok Ads: create an ad group with auto-paused status. promotion_type: WEBSITE / APP_ANDROID / APP_IOS / LEAD_GENERATION. placement_type PLACEMENT_TYPE_NORMAL also needs placements, for example ["PLACEMENT_TIKTOK"]. location_ids: TikTok geo ids; defaults to the United States (6252001). budget is a plain amount in the account currency, not cents; TikTok's daily minimum for an ad group is 20. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Upload videoSensitive write
tt_upload_video_toolTikTok Ads: upload a video asset. Pass exactly one source: video_url (a public MP4 URL), file_id (a file already uploaded to this advertiser) or video_id (a video already in its library). The source is what sets TikTok's upload_type. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Create adSensitive write
tt_create_ad_toolTikTok Ads: create an ad with auto-paused status. ad_format: SINGLE_VIDEO / SINGLE_IMAGE / CAROUSEL_ADS. identity_authorized_bc_id: required when identity_type is BC_AUTH_TT. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · List identitiesRead
tt_list_identities_toolTikTok Ads: list identities an ad can be published under. Each row carries the identity_id `tt_create_ad_tool` requires. identity_type filters to CUSTOMIZED_USER / TT_USER / BC_AUTH_TT / AUTH_CODE; omit it for all of them. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: data table.
-
TikTok Ads · Create identitySensitive write
tt_create_identity_toolTikTok Ads: create a custom identity to publish ads under. display_name is the name viewers see on the ad. image_uri is optional. Use this when `tt_list_identities_tool` comes back empty. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Create pixelSensitive write
tt_create_pixel_toolTikTok Ads: create a tracking pixel. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Send events api eventSensitive write
tt_send_events_api_event_toolTikTok Ads: send server-side event via Events API v2. User PII auto-hashed (email/phone/names) unless pre_hashed=True. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · List spark postsRead
tt_list_spark_posts_toolTikTok Ads: list organic posts authorized for Spark Ads. Each row carries the item_id and identity_id that `tt_create_spark_ad_tool` needs. Page size is capped at 50. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: data table.
-
TikTok Ads · Create spark adSensitive write
tt_create_spark_ad_toolTikTok Ads: create Spark Ad from organic post. Pass auth_code (the Spark Ads authorization code the post owner generated in the TikTok app) for a post this account has never run, or tt_post_id for one already listed by `tt_list_spark_posts_tool`. One of the two is required. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Reporting asyncRead
tt_reporting_async_toolTikTok Ads: request async report with task_id polling. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
-
TikTok Ads · Update ad statusSensitive write
tt_update_ad_status_toolTikTok Ads: enable/disable/delete campaign, ad group, or ad. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes whether an ad or campaign delivers.
-
TikTok Ads · Create global adgroupSensitive write
tt_create_global_adgroup_toolTikTok Ads: create global ad group (all placements). Placements automatically set to TikTok feed + Pangle + Global App Bundle. location_ids defaults to the United States (6252001). Visualization: confirmation card.
Changes data in a connected account.
-
Client management · CreateSensitive write
client_create_toolCreates a client record in this AdvisorPPC workspace, so ad accounts and reports can be grouped per client.
Changes data in a connected account.
-
Client management · ListRead
client_list_toolLists the clients in this AdvisorPPC workspace, for agencies running PPC accounts on behalf of others.
-
Client management · GetRead
client_get_toolFetch a single client by ID or slug, including all linked accounts. Visualization: card
-
Client management · UpdateSensitive write
client_update_toolUpdate a client's details. All fields are optional (partial update). Visualization: card
Changes data in a connected account.
-
Client management · ArchiveSensitive write
client_archive_toolArchive a client by setting status to 'offboarded'. Archived clients are hidden from default lists but not deleted. Visualization: card
Changes data in a connected account.
-
Client management · Link accountSensitive write
client_link_account_toolLink a platform account to a client. Platforms: google_ads, ga4, gtm, search_console, youtube, meta, bing, tiktok, linkedin, pinterest, x, gmc, business_profile. Visualization: card
Changes data in a connected account.
-
Client management · Unlink accountSensitive write
client_unlink_account_toolRemove an account mapping from a client. Visualization: card
Changes data in a connected account.
-
Client management · List accountsRead
client_list_accounts_toolLists the advertising and analytics accounts mapped to one client, across Google Ads, Meta, GA4 and the other connected platforms.
-
Client management · Log entrySensitive write
client_log_entry_toolCreate a manual work log entry for a client. kind: action | audit | recommendation | note | meeting | report | alert severity: info | low | medium | high | critical Returns {entry_id, markdown} on success, {error: ...} on failure. Visualization: confirmation card.
Changes data in a connected account.
-
Client management · Get worklogRead
client_get_worklog_toolFetch recent work log entries for a client, newest first. Grouped by date in markdown timeline. kind_filter and severity_filter are optional (None = no filter). Returns {client_id, count, entries, markdown}. Visualization: timeline.
-
Client management · Search worklogRead
client_search_worklog_toolSearch work log entries by title + detail (LIKE search). Returns matching entries with snippet markdown. Visualization: data table.
-
Client management · Recent activitySensitive write
client_recent_activity_toolFetch recent activity across ALL clients for the current user. Returns markdown grouped by client. Useful for "what happened across all my clients last week?". Visualization: timeline.
Changes data in a connected account.
-
Client management · Log summaryRead
client_log_summary_toolSummary stats for a client's work log. Returns counts by kind + severity, busiest day, most-used tool, and markdown summary card. Visualization: summary card.
-
Client management · Set brand voiceSensitive write
client_set_brand_voice_toolSet or update a client's brand voice card. Captures tone, target audience, forbidden phrases, and competitor references. Auto-injects into all future ad copy and creative briefs for this client. Visualization: memory card.
Changes data in a connected account.
-
Client management · Get brand voiceRead
client_get_brand_voice_toolFetch a client's brand voice card. Returns the full voice card + tone + target audience + forbidden/must-include phrases. Visualization: memory card.
-
Client management · Save brief outputSensitive write
client_save_brief_output_toolSave an AI-generated brief output as a memory artifact for the client. brief_kind: brand_voice | structure | audience_strategy | competitor_intel | ad_copy_template | custom Stores the markdown so it can be referenced in future briefs & planning. Visualization: memory card.
Changes data in a connected account.
-
Client management · Full auditRead
client_full_audit_tool(recommend-only) Complete multi-platform audit for ONE registered client - runs every linked platform's audit and merges the results. NEVER executes. When to use: "audit <client>" / monthly client review across Google Ads, GA4, GTM, Search Console, Meta, Bing, YouTube at once. For a single Google Ads account use `ga_audit_account_tool`; for a shareable visual use `client_dashboard_html_tool` (which calls this internally); for the whole agency book use `agency_priority_queue_tool`. Preconditions: the client must exist in the client registry (`client_create_tool` or `client_list_tool` to find the slug/id) and have platform accounts linked via `client_link_account_tool` - otherwise this returns an error, not an empty audit. Returns: dict with [client, audit_period, platforms_checked, platforms_skipped (with per-platform reason), summary {total_findings, by_severity, score 0-100}, findings_by_platform, all_proposed_actions (severity-sorted), markdown]. Gotchas: - Recommend-only: surface all_proposed_actions as an approval list; apply ticked items with the per-platform write tools. - A platform erroring (expired token, no access) lands in platforms_skipped - always report skips or the audit looks healthier than it is. - Fans out to several platform APIs; expect the slowest call in the set to dominate latency. Example: client_full_audit_tool(client_id_or_slug="game-over-burlington", days=30) Visualization: audit summary card with score + severity breakdown.
-
Client management · Dashboard htmlRead
client_dashboard_html_toolRender a live-data HTML dashboard for one client. Calls the full audit internally and wraps results in a self-contained HTML artifact with KPI cards, platform status, findings, and top actions. Fully responsive and requires no external assets. Returns {html, filename, markdown}. Visualization: html artifact.
-
Client management · Export pdfRead
client_export_pdf_toolClient: Export white-label PDF monthly report. Generates an HTML dashboard and converts to PDF. Requires weasyprint or xhtml2pdf in dependencies. Useful for client deliverables or archiving. Returns base64-encoded PDF for embedding. Visualization: pdf artifact.
-
TikTok Ads · Breakdown by countryRead
tt_breakdown_by_country_toolTikTok: breakdown by country/region. Visualization: data table.
-
Billing · My subscriptionRead
billing_status_tool(read-only) Show the caller's current plan and what it includes. When to use: the user asks "what am I subscribed to?", "what do I have access to?", "how many accounts can I connect?", "how many tool calls are left?", or "what does this cost?". To subscribe or move up a rung, use billing_upgrade_link_tool instead. Preconditions: the caller must be authenticated via MCP OAuth. No parameters needed. Returns: dict with keys plan_code, plan_name, plan_price_usd_month (the caller's own rung only), capabilities (plain-language list of what the plan unlocks), included_accounts, pricing_url (the public ladder with every rung and price) and manage_billing_url (the caller's billing page), trial (active flag; on Free or during the no-card Google Ads trial it also says whether calls are available right now and when the allowance resets; usage figures are never included), plus a markdown field with a mobile-friendly card. A caller still holding a retired per-platform subscription also gets legacy_platform_subs. On error, returns {"error": "..."} (never raises). Gotchas: - WHEN THE ALLOWANCE COMES BACK depends on the rung. A paid plan's monthly tool calls renew on the caller's own billing date, and only once that payment has cleared; a declined card leaves the allowance spent until the retry succeeds. The Free rung is never invoiced, so it keeps renewing on the first of each month in UTC. Never tell a paying caller their calls come back on the first of the month. - Pricing is ONE cumulative ladder, one subscription per tenant, and each rung contains everything below it. This tool reports the caller's OWN rung and price only; it does not list the other rungs. For "what does the next plan cost?" send the user to pricing_url - never quote a figure from memory. - The old starter/creator/growth/pro/agency plans and the old per-platform subscriptions are RETIRED. Never quote them. - Rungs that are not on sale yet are NOT purchasable - send the user to the waitlist on pricing_url, never to checkout. Example: billing_status_tool() Visualization: subscription card for the caller's own plan and usage.
-
Billing · Subscribe to a planRead
billing_upgrade_link_tool(read-only) Generate a secure, tappable checkout link for a plan. When to use: the user says "subscribe to Google Ads", "I want GA4 too", "upgrade me", "get me a checkout link", or "how much is the Google suite". Use billing_status_tool first if you need to know what they already have. Preconditions: - plan is a public-line code: google_ads (Pro), google_suite, plus_tiktok, all_access (Max) or agency_scale. Checkout mints only for on-sale SKUs whose Stripe price resolves (today: Pro and Google Suite). Platform names resolve to the cheapest public-line rung that includes them (ga4/gtm -> google_suite, meta/tiktok -> plus_tiktok, linkedin/microsoft/twitter -> all_access). - annual=true gives the annual price (2 months free) if configured. - `platform` is a deprecated alias for `plan`; pass `plan`. - The link is personal and expires in 30 minutes. Do not share it publicly. Returns: dict with keys url (absolute HTTPS link, tap to open Stripe checkout), plan, plan_name, annual (bool), price_line, included_accounts, extra_account_usd, and a markdown field with a tappable card showing what the plan unlocks. For a rung that is not on sale yet, returns a waitlist card (coming_soon=true, waitlist_url) and NO checkout link. On missing Stripe config the card links to /pricing. On error, returns {"error": "..."} (never raises). Gotchas: - One subscription per tenant on a cumulative ladder - the user does not buy platforms separately, they move up a rung. - Only Pro (google_ads, catalog.TRIAL_PLAN_CODES) starts with a 14-day free trial, one per person: checkout collects the card up front and charges nothing until the trial ends. Other paid rungs have no card trial. A reserve-only rung (catalog.DEFERRED_START_CODES, while deferred_start.is_reserving) saves the card and charges nothing until it is activated. Anything else is charged at checkout. Never promise a trial on any other plan. - plus_tiktok / all_access are waitlist-only until those ad providers finish app review. Never promise a connection you cannot deliver, and never mint a checkout link for them. Retired MCP SKUs are not sold. Example: billing_upgrade_link_tool(plan="google_ads") billing_upgrade_link_tool(plan="google_suite", annual=True) Visualization: subscription card with tappable checkout link and unlocked features.
-
SearchRead
search(read-only) Search AdvisorPPC's tool catalog for capabilities. When to use: ChatGPT Deep Research / connector retrieval. Returns the connector tools whose name or description match `query` so the model can discover what AdvisorPPC can do. Pair each hit's `id` with `fetch` to read the full tool documentation. Read-only; no external API calls. Returns: dict with `results` -> list of {id, title, url}.
-
FetchRead
fetch(read-only) Fetch full documentation for one AdvisorPPC tool. When to use: after `search`, pass a result `id` (e.g. "tool:ga_...") to read that tool's complete description. Read-only; no external API calls, no user data. Returns: dict with {id, title, text, url, metadata}.
-
Atmosmotion · Copy search knowledgeSensitive write
atm_copy_search_knowledgeSearch the Atmosmotion copywriting knowledge base. Returns ranked chunks for use as context. Args: query (str), limit (int, default 6), source_filter (str, optional).
Changes data in a connected account.
-
Atmosmotion · Copy rulesRead
atm_copy_rulesReturn the Atmosmotion copywriting checklist. Apply to every customer-facing draft.
-
Atmosmotion · Copy voice filterRead
atm_copy_voice_filterScan text for non-human / robotic-sounding patterns. Returns a list of labels; empty list = passed.
-
Atmosmotion · Copy length budgetsRead
atm_copy_length_budgetsReturn the length-budget table for an ad surface. Args: surface ("google" | "meta" | "tiktok" | "landing" | "email" | "blog" | "motion" | "banner").
-
Atmosmotion · Copy assemble adSensitive write
atm_copy_assemble_adAssemble a paste-ready prompt for ad copy on any surface - google, meta, tiktok, landing, email, blog, motion (video ads), banner (display ads). Args: brand_summary (str), surface, target (str), platform_placement (str, optional). For motion/banner/image surfaces the result includes a render_handoff naming the visual tool (atm_render_image / atm_motion_animate / atm_html_banner) to pipe the copy into.
Changes data in a connected account.
-
Atmosmotion · Engine advisorRead
atm_engine_advisorRecommend which Atmosmotion engine to use for a piece of creative work, and which specialist agents to staff on it. Returns a primary engine + agent chain + example call + fallbacks. Args: work_kind (one of 'banner' | 'typography_card' | 'vector_layout' | 'ad_image' | 'motion_loop' | 'motion_intro' | 'effects_pass' | 'ad_copy' | 'landing_hero'), constraints (dict, optional).
-
Atmosmotion · Engine catalogRead
atm_engine_catalogReturn the complete Atmosmotion inventory: 7 engines (Earth-Saturn), every tool with whether it hands back a finished FILE or a job SPEC the caller must run itself, the AE-parity effect IDs, and the specialist agent roles. Call this once at session start, before asking atm_engine_advisor for routing. Args: cavemotion (bool, optional).
-
Atmosmotion · Lesson recordSensitive write
atm_lesson_recordRecord the outcome of an Atmosmotion creative job so the engine advisor can learn over time. Pass the engine you actually used (planet codename: Earth / Moon / Mercury / Venus / Mars / Jupiter / Saturn), whether it succeeded, and optional latency + notes. success=True means ONLY: you executed the spec, verified the output file exists and is valid, AND judged the pixels acceptable (per exec.agent_protocol). If you did not execute + verify + judge - or the render was broken - record success=False. Never log a hallucinated win; it poisons engine routing for every user. Args: work_kind (str - matches atm_engine_advisor work_kinds), engine (planet codename), success (bool), latency_ms (int, optional), notes (str, optional).
Changes data in a connected account.
-
Atmosmotion · Lesson recallRead
atm_lesson_recallRecall recorded engine outcomes for a work_kind. scope='global' returns the top engines ranked by success rate across all users; scope='personal' returns the calling user's recent lessons. Args: work_kind (str), scope ('personal'|'global'), limit (int, default 5).
-
Client management · Get structure notesRead
client_get_struct_notes_toolFetch a client's account structure notes. Returns structure strategy, naming convention, budget allocation, targets, geos, attribution. Visualization: memory card.
-
Client management · Set structure notesSensitive write
client_set_struct_notes_toolSet or update a client's account structure notes. Captures naming conventions, budget allocation %, performance targets, and geo/attribution strategy. Auto-references in all future account planning tools for this client. Visualization: memory card.
Changes data in a connected account.
-
TikTok Ads · Breakdown by age genderRead
tt_breakdown_age_gender_toolTikTok: demographic breakdown by age and gender. Visualization: data table.
-
TikTok Ads · Create pangle only adgroupSensitive write
tt_pangle_only_adgroup_toolTikTok Ads: create Pangle-only ad group (display network). Placements automatically set to PLACEMENT_PANGLE for native/banner ads. location_ids defaults to the United States (6252001). Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Create tiktok only adgroupSensitive write
tt_tiktok_only_adgroup_toolTikTok Ads: create TikTok-feed-only ad group. Placements automatically set to PLACEMENT_TIKTOK for organic feed delivery. location_ids defaults to the United States (6252001). Visualization: confirmation card.
Changes data in a connected account.
-
TikTok Ads · Breakdown by placementRead
tt_split_by_placement_toolTikTok: breakdown by placement (TikTok / Pangle / Global). Visualization: data table.
-
TikTok Ads · Create custom audienceSensitive write
tt_create_custom_aud_toolTikTok Ads: create a custom audience. Default account: omit advertiser_id to use the account ticked on the dashboard "Connected accounts" card. Visualization: confirmation card.
Changes data in a connected account.
TikTok organic
4 tools · 2 read · 2 write
-
TikTok organic · Creator infoRead
tt_organic_creator_info_toolTikTok organic: get the connected creator's nickname, avatar, current privacy choices, disabled interactions and video duration limit. Paid TikTok access required. Show this to the user before preparing a post.
-
TikTok organic · Publish videoSensitive write
tt_organic_publish_video_toolTikTok organic: preview then Direct Post a video from media.advisorppc.com. Never choose privacy for the user. Show the creator, playable video, editable caption, interaction settings, commercial disclosures and Music Usage Confirmation. Ask for explicit user consent. Only then repeat the exact arguments with confirm=true, consent=true and the preview's single-use confirm_token. Branded content also requires agreement to TikTok's Branded Content Policy. The server verifies MP4 duration independently (128 MiB maximum); caller duration is informational. Unverifiable or changed media is rejected. Show measured_duration_seconds and the exact commercial_disclosure sentence from the preview. Unaudited apps are private-only; never silently change privacy. Processing is not publication. Use the status tool to poll a returned publish_id; never automatically retry an uncertain upload.
Publishes content publicly on the user's behalf.
-
TikTok organic · Upload inboxSensitive write
tt_organic_upload_inbox_toolTikTok organic: preview then upload a video to the creator's inbox for completion in TikTok. Video URL must be on media.advisorppc.com. The server independently verifies MP4 duration (128 MiB maximum) and rejects unverifiable or changed media. Show the creator, video and Music Usage Confirmation and ask for explicit consent before repeating with confirm=true, consent=true and the single-use confirm_token. This does not publish a post. Open TikTok's inbox notification to choose caption, privacy, disclosures and finish. Poll the returned publish_id with the status tool.
Changes data in a connected account.
-
TikTok organic · StatusRead
tt_organic_status_toolTikTok organic: fetch processing, published, inbox or failure status for a publish reference created by your current connection. Poll pending requests every few seconds; do not repeat the upload.
TikTok Ads
5 tools · 5 read
-
TikTok Ads · Top creativesRead
tt_top_creatives_toolTikTok: top performing creatives. Sort by: spend, impressions, clicks, conversions, ctr, cpc, cpa. Visualization: data table.
-
TikTok Ads · List campaignsRead
tt_list_campaigns_toolLists TikTok Ads campaigns with objective, status and budget.
-
TikTok Ads · List adgroupsRead
tt_list_adgroups_toolTikTok Ads: List ad groups in an advertiser or campaign. Visualization: data table.
-
TikTok Ads · Account performanceRead
tt_account_performance_toolReports TikTok Ads account performance: spend, impressions, conversions and cost per result.
-
TikTok Ads · Campaign performanceRead
tt_campaign_performance_toolTikTok Ads: Campaign-level performance with normalized metrics. Returns spend, impressions, clicks, CTR, CPC, conversions, ROAS per campaign. Dimensions: stat_time_day, stat_time_week, stat_time_month. Visualization: line chart.
Ready to try them? Start with the connection steps.