MCP

Tool Reference

All 30 tools available to your AI assistant through MCP, organized by category

How tools work

You don't need to call tools directly. Just describe what you want in natural language and your AI assistant will pick the right tool. Each tool costs credits — check your balance with get_credit_balance.

Campaign Management

List all campaigns across connected ad platforms. Returns campaign name, status, budget, and performance metrics.

Parameters

platformstring

Filter by platform (optional — lists all if not specified)

googlemetalinkedinmicrosoftreddittiktokx

statusstring

Filter by campaign status

ENABLEDPAUSEDREMOVED

limitnumber

Maximum number of campaigns to return (default: 50)

Create a complete Google Ads Search campaign with ad group, responsive search ad, and keywords. Creates everything needed for the campaign to run.

Parameters

campaign_namestringrequired

Name for the campaign

daily_budgetnumberrequired

Daily budget in USD

headlinesstring[]required

Ad headlines (3-15 required, max 30 chars each)

descriptionsstring[]required

Ad descriptions (2-4 required, max 90 chars each)

final_urlstringrequired

Landing page URL for the ad

keywordsstring[]required

Keywords to target

match_typestring

Keyword match type (default: PHRASE)

EXACTPHRASEBROAD

geo_targetsstring[]

Geo target codes (e.g., '2840' for US, '2826' for UK). Defaults to US.

Create a Google Ads Display campaign with responsive display ads. Supports image uploads from URLs plus bidding, geo, and placement controls.

Parameters

campaign_namestringrequired

Name for the campaign

daily_budgetnumberrequired

Daily budget in USD

landscape_image_urlstringrequired

URL to 1200x628 landscape image

square_image_urlstringrequired

URL to 1200x1200 square image

bidding_strategystring

Bidding strategy

maximize_clicksmaximize_conversionsmaximize_conversion_valuemanual_cpc

target_cpanumber

Target CPA in USD (used with maximize_conversions)

target_roasnumber

Target ROAS multiplier (used with maximize_conversion_value)

cpc_capnumber

CPC cap in USD when using maximize_clicks

positive_geo_target_typestring

How to match users to targeted locations

PRESENCEPRESENCE_OR_INTEREST

headlinesstring[]required

Headlines (1-5, max 30 chars each)

descriptionsstring[]required

Descriptions (1-5, max 90 chars each)

business_namestringrequired

Business name (max 25 chars)

final_urlstringrequired

Landing page URL

geo_targetsstring[]

Geo target codes

managed_placementsstring[]

Managed placement URLs or domains to target

Create a Google Ads Performance Max campaign. Requires images, headlines, descriptions, and a business name.

Parameters

campaign_namestringrequired

Name for the campaign

daily_budgetnumberrequired

Daily budget in USD

headlinesstring[]required

Headlines (3-15, max 30 chars each)

long_headlinestringrequired

Long headline (max 90 chars)

descriptionsstring[]required

Descriptions (2-5, max 90 chars each)

business_namestringrequired

Business name (max 25 chars)

final_urlstringrequired

Landing page URL

landscape_image_urlstring

URL to 1200x628 landscape image

square_image_urlstring

URL to 1200x1200 square image

logo_urlstring

URL to square logo (min 128x128)

geo_targetsstring[]

Geo target codes

target_cpanumber

Target CPA in USD (optional)

Pause a campaign by ID. Works across all connected platforms.

Parameters

campaign_idstringrequired

Campaign ID (platform-specific format)

platformstringrequired

Ad platform

googlemetalinkedinmicrosoftreddittiktokx

Update the daily budget for a campaign.

Parameters

campaign_idstringrequired

Campaign ID

platformstringrequired

Ad platform

googlemetalinkedinmicrosoftreddittiktokx

daily_budgetnumberrequired

New daily budget in USD

Performance & Analytics

Get performance metrics (impressions, clicks, spend, conversions, ROAS) for campaigns.

Parameters

platformstring

Filter by platform (optional)

googlemetalinkedinmicrosoftreddittiktokx

campaign_idstring

Filter by specific campaign ID (optional)

date_rangestring

Date range for metrics (default: LAST_7_DAYS)

TODAYYESTERDAYLAST_7_DAYSLAST_30_DAYSTHIS_MONTHLAST_MONTH

Get daily spend breakdown across all connected ad accounts.

Parameters

daysnumber

Number of days to look back (default: 7)

platformstring

Filter by platform (optional)

googlemetalinkedinmicrosoftreddittiktokx

Keywords

Add keywords to a Google Ads campaign or ad group.

Parameters

ad_group_idstringrequired

Ad group ID to add keywords to

keywordsstring[]required

Keywords to add

match_typestring

Keyword match type (default: PHRASE)

EXACTPHRASEBROAD

Add negative keywords to block unwanted search terms.

Parameters

campaign_idstringrequired

Campaign ID

keywordsstring[]required

Negative keywords to add

levelstring

Level to apply negatives (default: CAMPAIGN)

CAMPAIGNAD_GROUP

Conversion Tracking

Create a conversion action in Google Ads. Returns the conversion ID and label for GTM setup.

Parameters

namestringrequired

Name for the conversion action (e.g., 'Signup', 'Purchase')

valuenumber

Default conversion value in USD (optional)

categorystring

Conversion category (default: LEAD)

PURCHASESIGNUPLEADPAGE_VIEWADD_TO_CARTDOWNLOADOTHER

List all conversion actions configured in Google Ads.

No parameters required.

Check if conversion tracking is properly set up on a website. Verifies gtag.js, GTM, and pixel installation.

Parameters

urlstringrequired

Website URL to check

Creative Generation

Generate an AI image for ad creatives using Imagen 4, Flux, or Stable Diffusion.

Parameters

promptstringrequired

Image generation prompt (be specific about style, layout, colors)

sizestring

Image dimensions (default: 1200x628 for display ads)

1200x6281200x12001080x10801920x1080

providerstring

AI provider (default: imagen)

imagenfluxsdxl

namestring

Asset name for organization

Generate an AI video ad using Veo, Runway, or Luma. Great for YouTube and social ads.

Parameters

conceptstring

Video concept framework (default: pas = Problem-Agitate-Solve)

pasaidabefore_aftertestimonialdemoexecute

product_namestringrequired

Product or brand name

target_audiencestring

Who is this video for?

key_benefitstringrequired

Main value proposition

durationnumber

Video duration in seconds (default: 8)

681530

providerstring

AI provider (default: veo)

veorunwayluma

Meta Ads

Create a Meta (Facebook/Instagram) advertising campaign.

Parameters

namestringrequired

Campaign name

objectivestringrequired

Campaign objective

CONVERSIONSTRAFFICLEADSAWARENESSENGAGEMENT

daily_budgetnumberrequired

Daily budget in USD

LinkedIn Ads

Create a LinkedIn Ads campaign for B2B advertising.

Parameters

namestringrequired

Campaign name

objectivestringrequired

Campaign objective

WEBSITE_VISITLEAD_GENERATIONENGAGEMENTVIDEO_VIEWBRAND_AWARENESS

daily_budgetnumberrequired

Daily budget in USD

target_company_sizesstring[]

Target company sizes

1-1011-5051-200201-500501-10001001-50005001-1000010001+

target_industriesstring[]

Target industries (LinkedIn industry codes)

target_job_functionsstring[]

Target job functions (e.g., 'Marketing', 'Engineering', 'Sales')

Reddit Ads

Create a Reddit Ads campaign for community-based advertising.

Parameters

namestringrequired

Campaign name

objectivestringrequired

Campaign objective

TRAFFICCONVERSIONSVIDEO_VIEWSAPP_INSTALLSREACH

daily_budgetnumberrequired

Daily budget in USD

subredditsstring[]

Subreddits to target (optional — omit for interest-based targeting)

interestsstring[]

Interest categories to target

keywordsstring[]

Keywords to target (keyword targeting for search-intent reach)

Optimization & Bidding

Update the bidding strategy for a campaign. Supports maximize_clicks, maximize_conversions, maximize_conversion_value, and manual_cpc.

Parameters

campaign_idstringrequired

Campaign ID to update

strategystringrequired

New bidding strategy

maximize_clicksmaximize_conversionsmaximize_conversion_valuemanual_cpc

target_cpanumber

Target CPA in USD (optional, for maximize_conversions)

target_roasnumber

Target ROAS as percentage (optional, for maximize_conversion_value)

platformstring

Ad platform (default: google)

googlemetalinkedinmicrosoft

Get AI-powered bid adjustment recommendations based on campaign performance. Analyzes day-parting, device, and audience patterns.

Parameters

campaign_idstring

Campaign ID to analyze (optional — analyzes all if omitted)

daysnumber

Number of days of data to analyze (default: 30)

optimization_typestring

Type of optimization to analyze (default: all)

day_partingdeviceaudienceall

Get budget reallocation recommendations across campaigns based on ROAS and pacing. Identifies underspending and overspending campaigns.

Parameters

target_roasnumber

Target ROAS for optimization (default: uses account average)

total_budgetnumber

Total daily budget to allocate across campaigns (optional)

Check budget pacing for all campaigns. Shows spend vs budget, projected end-of-day spend, and pacing alerts.

Parameters

platformstring

Filter by platform (optional)

googlemetalinkedinmicrosoftreddittiktok

Get expert strategic advice from the AI Strategist. Use for complex decisions like campaign structure, bidding strategy selection, budget allocation, and performance troubleshooting.

Parameters

questionstringrequired

Your strategic question or problem to analyze

contextstring

Additional context about your account, goals, or constraints

website_domainstring

Primary website/domain to use for Similarweb-backed strategist analysis.

competitor_domainsstring[]

Optional competitor domains for strategist market comparison.

include_databoolean

Whether to include recent campaign data in analysis (default: true)

Utility

List all connected ad accounts across platforms.

No parameters required.

Upload an image as an asset for use in ads.

Parameters

image_urlstringrequired

URL of the image to upload

asset_namestringrequired

Name for the asset

platformstring

Target platform (default: google)

googlemetalinkedin

Landing Pages

Generate an AI landing page and save it as a draft. Returns a preview URL. Call publish_landing_page to make it publicly accessible.

Parameters

titlestringrequired

Page title shown in browser tab and meta tags

slugstring

URL slug (e.g. 'my-campaign'). Must be lowercase letters, numbers, hyphens.

promptstringrequired

Detailed brief for the AI to generate the page — include headline, value props, features, CTA copy, and visual style

cta_urlstringrequired

URL the CTA button links to (must be a real, working URL)

cta_textstring

CTA button label (e.g. 'Start Free Trial')

stylestring

Visual style preset (default: modern)

modernminimalbold

Upload raw HTML as a new landing-page draft (no AI generation). Import an exported .html file or hand-written markup — embedded lead forms, Cal.com scheduler embeds, and thank-you pages are all supported. Then publish_landing_page and attach it to an ad campaign.

Parameters

html_contentstringrequired

Full HTML string (or a fragment — it is wrapped in a document). Sanitized server-side; capped at 2 MB.

titlestring

Page title (defaults to "Uploaded Landing Page").

slugstring

URL slug (lowercase, hyphens). Auto-generated from title + date when omitted. Re-uploading a slug you own updates that page in place.

Publish a landing page draft, making it publicly accessible at syntermedia.ai/lp/{slug}. Only call after the user has reviewed the draft.

Parameters

slugstringrequired

Slug of the landing page to publish

Update the HTML content of an existing landing page without AI regeneration. Use this to patch logos, copy, CTAs, or layout after reviewing a draft.

Parameters

slugstringrequired

Slug of the landing page to update

html_contentstringrequired

Full HTML string to replace the current content

Advanced

Run any Synter tool by name. Use this for advanced operations not covered by other tools. See docs.syntermedia.ai for full tool list.

Parameters

script_namestringrequired

Name of the tool to run (e.g., 'google_ads_list_audiences')

argsstring[]

Arguments to pass to the tool

platformstring

Platform for OAuth credentials (google, meta, linkedin, etc.)

Example usage

Just ask naturally — your AI assistant picks the right tool:

You say	Tool used
What's my Google Ads spend this week?	`get_performance`
Show all my active campaigns	`list_campaigns`
Pause the Brand Search campaign	`pause_campaign`
Create a search campaign for our new product	`create_search_campaign`
Generate a hero image for my landing page	`generate_image`
How should I allocate budget across campaigns?	`get_budget_recommendations`
Is my conversion tracking set up correctly?	`diagnose_tracking`
Create a LinkedIn campaign targeting VPs of Marketing	`create_linkedin_campaign`

Was this page helpful?

PreviousConfiguration Next MCP Server Launch