amekala/ads-mcp

A cross-platform ad management server that connects your AI assistant to Google Ads, Meta, TikTok, and LinkedIn APIs. You get 175+ tools spanning the full campaign lifecycle: keyword research with real CPC data, campaign creation across search, display, Performance Max, and social formats, performance analysis with wasted spend detection, and optimization recommendations. Useful when you're managing multi-platform campaigns and want to research keywords, launch ads, or pull analytics without switching between four different dashboards. Handles OAuth 2.1 authentication and supports structured campaign planning with persistent strategy files. Also available as REST endpoints if you need direct API access outside an MCP client.

GitHub stars: 106
tools: 19
transport: HTTP
last updated: Jul 14, 2026

View on GitHub

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

paidsync_execRun 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.ca...3 params

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.ca...

Parameters* required

codestring

TypeScript/JavaScript code to execute. The code body runs inside an async wrapper. Use `return value;` to send a result back. Call PaidSync tools via `await paidsync.call("tool_name", { ...args })`.

modestring

Execution mode. `interactive` (60s default, 90s max) for chat. `scheduled` (5min, 15min max) for cron. `async` (30min, 60min max) for long jobs.one of interactive · scheduled · asyncdefault: interactive

timeout_msinteger

Override default timeout for the chosen mode. Capped at the mode's ceiling.

paidsync_contextReturns the current PaidSync runtime context: user, active account, connected platforms, and a compact tool catalog. Call this FIRST in any new exec session. By default returns a platform-grouped summary of available tools. Pass include_tools to drill into specific platform gr...1 params

Returns the current PaidSync runtime context: user, active account, connected platforms, and a compact tool catalog. Call this FIRST in any new exec session. By default returns a platform-grouped summary of available tools. Pass include_tools to drill into specific platform gr...

Parameters* required

include_toolsvalue

Optional. 'google_ads', 'ga4', 'gtm', 'gsc', 'merchant', 'facebook_ads', 'linkedin_ads', 'tiktok_ads', 'account', or '*'. Accepts a single string or an array of strings. If omitted, returns only th...

paidsync_tool_detailGet 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.1 params

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.

Parameters* required

namestring

Exact tool name, e.g. 'list_campaigns' or 'create_search_campaign'.

paidsync_recent_runsList 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.1 params

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.

Parameters* required

limitinteger

Max number of runs to return. Default 10, max 50.default: 10

paidsync_workflows_listList 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 pai...1 params

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 pai...

Parameters* required

ownerstring

Filter by owner. Default 'all' returns both.one of me · paidsync · alldefault: all

paidsync_workflows_runExecute 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).3 params

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).

Parameters* required

modestring

Execution mode (timeout tier). Same semantics as paidsync_exec.one of interactive · scheduled · asyncdefault: interactive

namestring

Workflow name, e.g. 'account-audit' or 'find-waste'.

paramsobject

Workflow parameters. See paidsync_workflows_list for each workflow's schema.

paidsync_workflows_saveSave 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.5 params

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.

Parameters* required

codestring

TypeScript code body. Use paidsync.call / paidsync.callMany. Use 'params' to access caller-supplied params.

descriptionstring

Short description for discoverability.default:

idstring

Pass to UPDATE an existing workflow. Omit to CREATE.

modestring

one of interactive · scheduled · asyncdefault: interactive

namestring

Workflow name. Letters, digits, hyphens recommended.

paidsync_workflows_deleteDelete one of your saved workflows by id. Only the workflow owner can delete it.1 params

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

Parameters* required

idstring

Workflow id returned from paidsync_workflows_save.

paidsync_workflows_describePlain-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 use...1 params

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 use...

Parameters* required

namestring

Workflow name (official) OR 'me:<name>' / Firestore id (user-saved).

paidsync_qa_suiteComprehensive read-only QA tester. Walks every read endpoint across all 7 PaidSync-safe platforms (Google Ads, Meta, LinkedIn, GA4, GTM, GMC, GSC), reports per-tool success/failure/duration/sample/error. Uses PaidSync-owned accounts only — NEVER touches client data, NEVER muta...2 params

Comprehensive read-only QA tester. Walks every read endpoint across all 7 PaidSync-safe platforms (Google Ads, Meta, LinkedIn, GA4, GTM, GMC, GSC), reports per-tool success/failure/duration/sample/error. Uses PaidSync-owned accounts only — NEVER touches client data, NEVER muta...

Parameters* required

accountsobject

Override safe-account IDs per platform. Omitted entries auto-discover via list_* helpers.

platformsarray

Subset of platforms to test. Omit to test all 7.

set_active_accountSet which Google Ads account to operate on. Provide mcc_id to set a specific MCC, or omit it to keep the current MCC. To switch to direct access (no MCC), set direct_access=true.4 params

Set which Google Ads account to operate on. Provide mcc_id to set a specific MCC, or omit it to keep the current MCC. To switch to direct access (no MCC), set direct_access=true.

Parameters* required

account_idstring

Google Ads account/customer ID (e.g. 123-456-7890)

account_namestring

Friendly name for the account

direct_accessboolean

Set true to explicitly clear MCC and use direct account access

mcc_idstring

MCC (manager account) ID if this account is under a manager

connect_google_adsInitiate OAuth flow to connect your Google Ads account. Opens a browser window for authentication.

Initiate OAuth flow to connect your Google Ads account. Opens a browser window for authentication.