PaidSync

Connect a Pinterest Ads account via OAuth. Opens a URL for the user to authorize PaidSync to manage their Pinterest Ads accounts. After connecting, use list_pinterest_accounts to see accessible ad accounts.

connect_pinterest_ads

Connect a Reddit Ads account via OAuth. Opens a URL for the user to authorize PaidSync to manage their Reddit Ads (Marketing) accounts. After connecting, use list_reddit_accounts to see accessible ad accounts.

connect_reddit_ads

Connect a Snapchat Ads account via OAuth. Opens a URL for the user to authorize PaidSync to manage their Snapchat Marketing API accounts. After connecting, use list_snapchat_accounts to see accessible ad accounts.

connect_snapchat_ads

Connect your TikTok Ads account via OAuth. Opens a URL for the user to authorize. At consent the user selects which advertiser accounts PaidSync can manage. After connecting, use list_tiktok_advertisers to see the granted IDs.

connect_tiktok_ads

Connect an X Ads (Twitter Ads) account via OAuth. Opens a URL for the user to authorize PaidSync to manage their X Ads accounts. After connecting, use list_x_accounts to see accessible ad accounts.

connect_x_ads

Get account name, currency, timezone, and status for the active Google Ads account

get_account_summary

Get ad-level performance breakdown: see which individual ads are performing best with impressions, clicks, CTR, CPC, conversions

get_ad_performance

Campaign performance breakdown sorted by spend: impressions, clicks, CTR, CPC, cost, conversions, budget, and status per campaign.

get_campaign_performance

Keyword performance report: top 100 keywords by cost or conversions with spend, clicks, impressions, quality score, max CPC bid. Sort with sort_by (cost or conversions). CTR and CPC are derivable from the returned clicks, impressions, and cost.

get_keyword_performance

Get account-level performance metrics: impressions, clicks, CTR, CPC, conversions, cost, ROAS for a date range

get_performance_summary

Search terms report: queries that triggered your ads with per-query spend, clicks, and conversions to spot wasted spend and add negatives.

get_search_terms_report

Get a consolidated wasted spend report showing all sources of waste: zero-conversion keywords, costly search terms with no results, low Quality Score keywords draining budget, and ads with zero clicks. Returns total recoverable spend with specific items to fix.

get_wasted_spend_report

List all portfolio (shared) bidding strategies with their type, status and performance: clicks, cost, impressions, conversions, cost per conversion and average CPC. RMF R.130.

list_bidding_strategies

Discover PaidSync's full catalog of 400+ ad tools and how to run them. PaidSync reads and manages ads across Google, Meta, LinkedIn, TikTok, Microsoft, Snapchat, Reddit, Pinterest, X (Twitter), plus GA4, GTM, Search Console, and Merchant Center: per-campaign, per-keyword, and search-term performance reports, wasted-spend and account audits, budgets, bidding, audiences, conversions, and mutations. Call this FIRST in any session: it returns the active account, connected platforms, and a platform-grouped tool catalog. Pass include_tools to drill into a group (e.g. ['google_ads'], ['ga4']) or '*' for the full catalog; exact tool names appear there. Do NOT tell the user a report or capability is unavailable without calling this and checking the relevant group first (a per-keyword report is get_keyword_performance).

paidsync_context

Run TypeScript code in a sandboxed PaidSync runtime with access to every ad-platform tool via `await paidsync.call(toolName, args)`. Use this when you need to compose multiple operations: filter, batch, conditional logic, derived data. Example: `const camps = await paidsync.call("list_campaigns", {}); const active = camps.filter(c => c.status === "ENABLED"); return active.length;`. Sandbox has no network, no fs, no process access. Output capped at 1MB. Default timeout 60s for interactive mode.

paidsync_exec

List the user's recent paidsync_exec runs. Each entry includes the code snippet, success status, duration, call count, trace summary, and value preview. Useful for debugging the last AI exec or replaying a workflow.

paidsync_recent_runs

Get the full schema (name, description, input parameters) for a single PaidSync tool by name. Use this when you know which tool you need but want to confirm its exact arguments before calling it from inside paidsync_exec.

paidsync_tool_detail

Delete one of your saved workflows by id. Only the workflow owner can delete it.

paidsync_workflows_delete

Plain-English explainer of what a workflow does, derived by scanning its code for paidsync.call(...) invocations. Useful for the Lab UI 'What does this do?' button and for non-technical reviewers before running a workflow. Resolves either an official workflow by name, or a user-saved workflow by id or 'me:<name>'.

paidsync_workflows_describe

List workflows available to run. Returns both PaidSync official workflows AND your own saved workflows. Pass owner='me' to filter to user-owned, owner='paidsync' for official only, or omit for both. Workflows are named, parameterized TypeScript compositions that run in the paidsync_exec sandbox.

paidsync_workflows_list

Execute a named workflow with parameters. Returns the workflow's structured result. Workflows run with the same safety guarantees as paidsync_exec (mutation block, audit trail).

paidsync_workflows_run

Save a user-owned workflow that can be run later via paidsync_workflows_run({ name: 'me:<name>' }). Available on Plus, Pro, and Max plans. Pass id to update an existing workflow, omit to create.

paidsync_workflows_save

Run a senior-level audit of your Google Ads account across 20 dimensions: wasted spend, search terms, Quality Score, RSA ad strength, extensions, negative keywords, impression share, bidding strategy, audience coverage, ad testing, device performance, geo performance, match type mix, URL tracking, campaign structure, ad schedule, budget pacing, conversion tracking, performance vs target, and Shopping/PMax. Window: last 30 days (budget pacing: this month). Each dimension scans a capped top-N slice by cost, so scores reflect where the money goes, not every entity. Returns an overall health score with money-impact findings labeled in the account currency.

run_account_audit

Set the active Facebook Ad Account for all subsequent Facebook operations. The ID is validated against your list of accessible accounts before being persisted.

set_fb_ad_account

Bind the active account to operate on. Defaults to Google Ads when `platform` is omitted (back-compat). To work on a NON-Google platform, pass `platform` (e.g. 'meta_ads', 'linkedin', 'tiktok', 'snapchat', 'reddit', 'pinterest', 'microsoft', 'openai', 'x', 'merchant') together with that platform's account_id. NO Google Ads connection is required and each platform binds independently. Google-only options: provide mcc_id for a specific MCC, or direct_access=true for no MCC. Pass account_id=null or empty string as a synonym for clear_active_account.

set_active_account

Select which Merchant Center account subsequent read/write tools should target. Required before any write operation. Get valid IDs from list_merchant_accounts. Accepts either `merchant_id` or `account_id` for compat with other set_active_* tools.

set_active_merchant_account

Select which Microsoft Advertising account subsequent read/write tools should target. Pass customer_id (from list_ms_accounts) so campaign writes have the required CustomerId header. Required before any write.

set_active_microsoft_account

Select which OpenAI Ads account subsequent tools should target. Get valid account ids from list_openai_accounts.

set_active_openai_account

Select which Pinterest ad account subsequent read/write tools should target. Required before any write. Get valid ids from list_pinterest_accounts.

set_active_pinterest_account

Select which Reddit ad account subsequent read/write tools should target. Required before any write. Get valid ids from list_reddit_accounts.

set_active_reddit_account

Select which Snapchat ad account subsequent read/write tools should target. Required before any write. Get valid ids from list_snapchat_accounts.

set_active_snapchat_account

Select which TikTok advertiser account subsequent read/write tools should target. Required before any write. Get valid IDs from list_tiktok_advertisers.

set_active_tiktok_advertiser

Select which X Ads (Twitter Ads) account subsequent read/write tools should target. Required before any write. Get valid ids from list_x_accounts.

set_active_x_account

Set the active LinkedIn Ad Account for all subsequent LinkedIn operations.

set_linkedin_ad_account