add_keywords
Add keywords to a Google Ads campaign or ad group.
LABSCO SUMMARY
Not a reporting connector — this one spends money, and the project says so before anything else.
The read half is ordinary enough: campaigns, performance and daily spend across whatever is connected. The write half is what separates it from most ad integrations, which are read-only by design. Campaigns get created and start spending, budgets change, keywords go live, and generated creative can be uploaded straight into an account. Audience sync stages hashed identifiers separately and carries a consent flag, which is the right shape for that data. Confirmations sit in front of destructive actions; how much authority to hand over is still a decision you make.
What it is
A server over Synter reaching the ad accounts connected to it across platforms: list and create campaigns, change budgets, pause them, manage keywords, set up conversion tracking, generate image and video creative, and sync first-party audiences.
What you get
- create_search_campaign builds a Google Ads Search campaign with its ad group, a responsive search ad and keywords in one atomic request; create_display_campaign and create_pmax_campaign cover the other Google formats, taking images from URLs
- create_meta_campaign for Facebook and Instagram, create_linkedin_campaign with industry, company-size and job-function targeting, and create_reddit_campaign with subreddit and interest targeting
- list_campaigns spans the connected platforms with status, budget and performance; get_performance returns impressions, clicks, spend, conversions and ROAS for a date range; get_daily_spend breaks spend down day by day across accounts
- pause_campaign and update_campaign_budget act by campaign ID across whichever platform it belongs to
- add_keywords with a match type, and add_negative_keywords at campaign or ad-group level to block search terms you do not want
- create_conversion returns the conversion ID and label needed for GTM setup, list_conversions shows what already exists, and diagnose_tracking checks a URL for gtag.js, GTM and pixel installation
- generate_image produces ad creative through Imagen 4, Flux or Stable Diffusion and generate_video through Veo, Runway or Luma, with upload_image putting an asset into the platform
- Audience work: manage_audience builds Customer Match lists in Google Ads from emails, phones or company domains, sync_audience uploads to Google, Meta, LinkedIn, Microsoft, Reddit, TikTok or X, and stage_audience_artifact holds hashed identifiers in a private store first — both carry an explicit consent flag
- run_tool reaches the rest of the Synter catalogue by name for operations the typed tools do not cover
Requirements
A Synter API key, with the ad accounts connected on the Synter side. Locally, @synterai/mcp-server over stdio with SYNTER_API_KEY set; remotely, Streamable HTTP at https://mcp.syntermedia.ai/mcp/ with the key sent as an X-Synter-Key header, which is where the full hosted tool set lives. The project is direct about the consequence: an agent with this connected can create campaigns that begin spending immediately, and it ships confirmations in front of destructive actions.
Setup effort
One command plus a key — npx @synterai/mcp-server, then supply credentials
USE CASES
01
Launching a search campaign from a brief
One request creates the campaign, ad group, responsive search ad and keywords; negatives go on straight after so the first day is not wasted.
02
Checking what is working before spending more
Performance across a date range, daily spend by account, and the campaign list with status and budget beside it.
03
Cutting a loser and moving the money
Pause by campaign ID on whichever platform it lives on, then raise the daily budget on the one that is working.
04
Fixing conversion tracking that never worked
Check the site for gtag.js, GTM and pixel installation, then create the conversion action and take its ID and label into the tag manager.
05
Producing creative for a campaign
Generate the image or the video from a concept, then upload it as an asset the ads can use.
06
Uploading a customer list as an audience
Stage the hashed identifiers in the private artifact store, then sync them to the platforms with the consent flag set.
25 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_negative_keywords
Add negative keywords to block unwanted search terms.
create_conversion
Create a conversion action in Google Ads. Returns the conversion ID and label for GTM setup.
create_display_campaign
Create a Google Ads Display campaign with responsive display ads. Supports image uploads from URLs.
create_linkedin_campaign
Create a LinkedIn Ads campaign for B2B advertising.
create_meta_campaign
Create a Meta (Facebook/Instagram) advertising campaign.
create_pmax_campaign
Create a Google Ads Performance Max campaign. Requires images, headlines, descriptions, and a business name.
create_reddit_campaign
Create a Reddit Ads campaign for community-based advertising.
create_search_campaign
Create a Google Ads Search campaign with an ad group, responsive search ad, and keywords — all in one atomic request. IMPORTANT: You must supply at least 3 headlines (max 30 chars each) and at least 2 descriptions (max 90 chars each). Fewer than 3 headlines or fewer than 2 descriptions will cause the campaign to be rejected before any API call is made.
diagnose_tracking
Check if conversion tracking is properly set up on a website. Verifies gtag.js, GTM, and pixel installation.
generate_image
Generate an AI image for ad creatives using Imagen 4, Flux, or Stable Diffusion.
generate_video
Generate an AI video ad using Veo, Runway, or Luma. Great for YouTube and social ads.
get_daily_spend
Get daily spend breakdown across all connected ad accounts.
get_performance
Get performance metrics (impressions, clicks, spend, conversions, ROAS) for campaigns.
list_ad_accounts
List all connected ad accounts across platforms.
list_campaigns
List all campaigns across connected ad platforms. Returns campaign name, status, budget, and performance metrics.
list_conversions
List all conversion actions configured in Google Ads.
list_landing_pages
List all landing pages for the authenticated workspace, including publish status, custom domain, and URLs.
manage_audience
Create, upload to, or list first-party audiences in Google Ads via the Data Manager API. Supports Customer Match lists from emails, phone numbers, and company domains (B2B). Use action='create' to build a new audience, 'upload' to append members to an existing one, 'list' to see all audiences, 'status' to check an upload job, or 'list-sources' to see linked data sources (GA4, Merchant Center).
pause_campaign
Pause a campaign by ID. Works across all connected platforms.
run_tool
Run any Synter tool by name. Use this for advanced operations not covered by other tools. See docs.syntermedia.ai for full tool list.
stage_audience_artifact
Stage a hashed-PII payload (newline-delimited identifiers — SHA-256 emails, phones, or raw MAIDs) in Synter's private artifact store and return an opaque artifact_id. Pass that id to sync_audience via *_artifact_id parameters. FREE — no credits charged. Use this instead of pasting hashed identifiers inline when you have more than ~500 entries.
sync_audience
Upload an audience to an ad platform (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X). Accepts inline hashed identifiers (hashed_emails, hashed_phones), raw mobile_ids (IDFA/GAID), company_domains, a public csv_url, or *_artifact_id references staged via stage_audience_artifact. Costs 10 credits on success.
update_campaign_budget
Update the daily budget for a campaign.
upload_image
Upload an image as an asset for use in ads.
BEFORE YOU INSTALL
What to know first
Tools you get
25 tools when we connected. run_tool reaches 140+ further Synter tools, and the hosted server at https://mcp.syntermedia.ai/mcp/ exposes a larger set. The README also describes an execute tool that dry-runs by default, but this package does not expose it; actions go through run_tool.
Requires
npx on PATH
CONTEXT COST
Moderate Standing cost
Rated by the size of the 25 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx @synterai/mcp-serverHosted endpoint
ENDPOINT URL
https://mcp.syntermedia.ai/mcp/Add this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"synter": {
"command": "npx",
"args": [
"@synterai/mcp-server"
],
"env": {
"SYNTER_API_KEY": "<YOUR_SYNTER_API_KEY>"
}
}
}
}Amp
AMP · JSON
{
"amp.mcpServers": {
"synter": {
"command": "npx",
"args": [
"@synterai/mcp-server"
],
"env": {
"SYNTER_API_KEY": "<YOUR_SYNTER_API_KEY>"
}
}
}
}ChatGPT — remote, n8n — remote, Zapier — remote
URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here
Claude Code — Plugin
CLAUDE CODE — PLUGIN · IN CLIENT
/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter
