MCP Server v1.0: 141 tools available

Give your AI agents
real advertising infrastructure.

141 MCP tools that let AI agents build audiences, launch campaigns, generate creatives, and pull analytics across LinkedIn, Google, Meta, Reddit, and more channels. Your marketing team sets the strategy. The agents handle the execution at scale.

Get API Key Read the Docs
claude mcp add --transport http metadataone https://mcp-server.metadata.io/mcp metadataone
141
MCP Tools
8
Ad Channels
14
Tool Categories
$0
To Start
Why MCP

Your AI can plan campaigns.
Now it can run them.

AI agents are great at reasoning about marketing strategy. But until now, they could not actually execute: no launching ads, no building audiences, no managing budgets. Metadata's MCP server gives them direct access to real ad operations across 8 channels.

▶

Launch real campaigns

Your agent calls create_campaign and launch_campaign. Real ads go live on LinkedIn, Google, and Meta within minutes. Not a simulation.

⚙

Build audiences programmatically

13 audience creation tools: firmographic, technographic, intent (Bombora and G2), retargeting, CSV import, LinkedIn/Meta native criteria. Your agent picks the right one.

★

Generate ad creatives

Extract brand kits from any domain, generate on-brand ad visuals, and deploy them across channels. All from a tool call.

■

Full-funnel analytics

Account timelines, conversion tracking, funnel reports, keyword performance, demographic breakdowns. Your agent reads results and optimizes.

⧉

Budget and experiment control

Set daily budgets, manage experiments, pause and restart keywords. Your agent allocates spend across experiments based on real performance data.

⍈

CRM and channel integrations

Connect Salesforce, HubSpot, and 8 ad channels. Your agent reads integration status and manages connections.

How It Works

One workflow. Five tool calls.
A live campaign.

launch_campaign.py
# 1. Extract brand identity from website brand = generate_brand_kit("acme.com") # 2. Build a target audience audience = create_firmographic_audience( name="Series B+ SaaS", industries=["Software"], employee_count="201-1000", seniority=["VP", "Director"] ) # 3. Generate ad creative creative = generate_brand_creative( brand_kit=brand, headline="Cut pipeline costs 40%" ) # 4. Create the campaign campaign = create_campaign( name="Q2 Pipeline Blitz", channels=["linkedin", "google"], audiences=[audience.id], ads=[creative.id] ) # 5. Go live launch_campaign(campaign.id) # Real ads. Real spend. Real pipeline.

From zero to live campaign in 5 calls

Your agent handles the full workflow. Each tool call maps to a real platform operation. No SDKs to maintain, no REST endpoints to manage, no OAuth flows to debug.

  • Agent scrapes target company's brand (colors, fonts, logo, tone)
  • Builds a firmographic audience of 200-1K companies matching ICP
  • Generates on-brand ad creative using the extracted brand kit
  • Creates a multi-channel campaign with audience and creative attached
  • Launches live. Real budget, real impressions, real leads flowing into CRM
Tool Catalog

141 tools across 14 categories

Every tool is a single MCP call. Read operations cost 1 credit. Create/update operations cost 5. Campaign launches and creative generation cost 10-25.

create_campaignCreate new campaign (Draft by default, multi-channel)10 cr
create_native_structure_campaignCreate a campaign using a channel's native structure10 cr
launch_campaignTransition campaign from Draft to LIVE (real spend begins)25 cr
manage_campaignPause, resume, or otherwise manage campaign state5 cr
add_and_edit_campaign_elementsAdd/replace audiences, ads, offers, keywords5 cr
get_campaign_by_wizard_idGet full campaign configuration and details1 cr
list_wizard_campaignsList wizard campaigns for the account1 cr
search_campaigns_by_namesFind campaigns by name (partial match)1 cr
add_exclusion_audiences_to_campaignAdd audiences to exclude from targeting5 cr
remove_audiences_from_campaignRemove specific audiences from channel5 cr
remove_channels_from_campaignDisable entire channel from campaign5 cr
remove_keywords_from_campaignRemove keywords from a campaign5 cr
remove_ad_from_campaignRemove specific ads from channel5 cr
remove_leadgen_offer_from_campaignRemove lead gen forms from channel5 cr
14 tools in Campaigns
create_budget_groupCreate a budget group to allocate spend across experiments5 cr
get_budget_groupRetrieve a specific budget group configuration1 cr
list_budget_groupsList all budget groups for the account1 cr
budget_group_performanceBudget group KPIs and experiment performance3 cr
4 tools in Budget Groups
create_audience_from_segmentCreate an audience from a saved insight segment5 cr
create_bombora_audienceIntent topic targeting with job function, seniority, geography5 cr
create_firmographic_audienceTarget by industry, employee count, revenue, location, job titles5 cr
create_technographic_audienceTarget by technology stack (Salesforce, HubSpot, etc.)5 cr
create_retargeting_audienceImport native channel audience as retargeting audience5 cr
create_g2_intent_dynamic_audienceG2 intent: visitors researching product categories (dynamic)5 cr
create_g2_intent_static_audienceG2 intent: static snapshot of in-market accounts5 cr
create_g2_intent_linkedin_native_dynamic_audienceG2 intent mapped to a LinkedIn native dynamic audience5 cr
create_facebook_native_criteria_audienceFacebook/Meta: industries, interests, job titles5 cr
create_linkedin_native_criteria_audienceLinkedIn native: job titles, skills, company names5 cr
create_csv_upload_linkedin_native_audienceBuild a LinkedIn native audience from an uploaded CSV5 cr
upload_account_list_csv_audienceCreate audience from company names + websites CSV5 cr
upload_contact_list_csv_audienceCreate audience from contact list CSV (300-300K contacts)5 cr
archive_audienceSoft-delete (archive) an audience5 cr
unarchive_audienceRestore archived audience5 cr
get_audience_detailsList all audiences with pagination and filtering1 cr
get_deep_audience_detailsGet detailed targeting criteria for specific audiences1 cr
get_matched_audiencesFind audiences by type and channel1 cr
get_retargeting_audiencesList available retargeting audiences1 cr
get_custom_audience_contacts_csv_urlGet the CSV export URL for a custom audience's contacts1 cr
20 tools in Audiences
create_segmentCreate an insight segment with multi-dimensional filters5 cr
list_segmentsList saved insight segments1 cr
get_segment_criteriaGet the filter criteria of a saved segment1 cr
search_insights_criteria_fieldsDiscover available insight filter fields1 cr
create_target_groupCreate target group with complex targeting rules5 cr
update_target_groupModify existing target group targeting rules5 cr
list_target_groupsList all target groups with search1 cr
retrieve_target_group_by_idGet full details of specific target group1 cr
estimate_target_groupEstimate audience size before creating1 cr
search_target_group_criteriaDiscover targeting criteria: locations, industries, seniority1 cr
10 tools in Segments & Target Groups
create_image_adCreate an image ad for a channel5 cr
create_video_adCreate a video ad for a channel5 cr
create_carousel_adCreate a multi-card carousel ad5 cr
create_update_convo_adCreate or update a LinkedIn conversation ad5 cr
create_update_google_ads_adCreate or update Google Ads text ads5 cr
create_update_linkedin_message_adCreate or update a LinkedIn message ad5 cr
get_ad_detailsGet full configuration for specific ads1 cr
search_ads_by_namesFind existing ads by partial name match1 cr
upload_image_creativeUpload image URL to platform library5 cr
upload_video_creativeUpload a video asset to the platform library5 cr
fetch_creative_detailsGet metadata for existing creative asset1 cr
generate_brand_creativeAI image generation for ad visuals25 cr
edit_brand_creativeModify existing creative using AI10 cr
search_library_images_by_nameSearch image library by name1 cr
generate_brand_kitScrape website to extract brand DNA (colors, fonts, logo, tone)10 cr
get_brand_kitLoad existing brand kit for a domain1 cr
update_brand_kitModify brand colors, fonts, typography, messaging5 cr
17 tools in Creatives & Ads
create_google_business_logo_extensionAdd a business logo extension to Google Ads5 cr
create_google_callout_extensionAdd callout extensions to Google Ads5 cr
create_google_image_extensionAdd an image extension to Google Ads5 cr
create_google_lead_form_extensionAdd a lead form extension to Google Ads5 cr
create_google_price_extensionAdd a price extension to Google Ads5 cr
create_google_promotion_extensionAdd a promotion extension to Google Ads5 cr
create_google_sitelink_extensionAdd sitelink extensions to Google Ads5 cr
create_google_structured_snippet_extensionAdd a structured snippet extension to Google Ads5 cr
8 tools in Google Ads Extensions
create_keywordsBatch create positive keywords for the ad library5 cr
list_keywordsList keywords with sorting and pagination1 cr
list_search_termsList the search terms that triggered your ads1 cr
create_negative_keywords_listCreate negative keyword list (exact/phrase/broad)5 cr
list_negative_keywords_listList all negative keyword lists1 cr
get_negative_keywords_list_detailsGet the keywords in a specific negative list1 cr
add_keywords_to_negative_listsAdd keywords to one or more negative lists5 cr
remove_keywords_from_negative_listRemove keywords from a negative list5 cr
8 tools in Keywords
search_experimentsFind experiments by name, status, or budget group1 cr
experiment_performance_statsExperiment-level metrics with sorting and filtering3 cr
experiments_keywords_statsKeyword performance data from experiments3 cr
list_experiment_keywordsGet keywords in specific experiment1 cr
pause_experiment_keywordPause keyword in active experiment5 cr
restart_experiment_keywordResume paused keyword in experiment5 cr
update_experiments_daily_budgetsAdjust daily budget allocation for active experiments5 cr
7 tools in Experiments
create_update_offerCreate a lead gen form or landing page offer5 cr
get_offerRetrieve existing offer details1 cr
find_offer_urlAuto-locate a suitable offer/landing page URL from a domain1 cr
find_privacy_urlAuto-locate the privacy policy URL from a domain1 cr
4 tools in Offers
connect_channelInitiate OAuth flow for ad channel (LinkedIn, Meta, Google, Reddit)5 cr
disconnect_channelRemove channel integration5 cr
connect_crmInitiate OAuth for Salesforce/HubSpot5 cr
get_integrations_statusCheck connected channels and CRM status1 cr
get_linkedin_sendersList authorized LinkedIn message/conversation ad senders1 cr
create_reddit_target_groupCreate a Reddit target group for ad targeting5 cr
search_reddit_criteriaDiscover Reddit targeting criteria (communities, interests)1 cr
update_reddit_channel_settingsUpdate Reddit channel configuration settings5 cr
8 tools in Channels & Integrations
performance_metricsGranular metrics: ads, audiences, creatives, offers3 cr
account_level_statsAccount-level KPIs: spend, leads, CPL, ROI, opportunities3 cr
account_funnel_reportsAccount progression: reached, engaged, converted3 cr
account_list_performanceAccount list engagement metrics and progression3 cr
deep_funnel_statsComprehensive funnel conversion analysis with ROI3 cr
demographic_country_statsPerformance metrics grouped by country3 cr
website_engagement_statsWebsite traffic, sessions, visitor behavior3 cr
get_insights_reportQuery account journeys with filtering and pagination3 cr
8 tools in Performance & Reporting
get_abm_account_listsList ABM account lists available for targeting1 cr
get_account_detailsReturns account name, ID, connected channels1 cr
get_account_summary_insightsQuick engagement/revenue lookup for domain(s)1 cr
get_account_timeline_insightsChronological touchpoint timeline by type3 cr
get_account_conversions_insightsConverted contacts (leads) by domain3 cr
get_account_opportunities_insightsPipeline opportunities by domain3 cr
6 tools in ABM / Account Insights
get_converted_leadsRetrieve converted leads with detail3 cr
get_converted_leads_summarySummary counts of converted leads1 cr
get_intent_topicsList Bombora intent topics available for targeting1 cr
3 tools in Leads & Conversions
list_user_accountsList all accessible accounts1 cr
get_current_dateReturn the server's current date for relative date math1 cr
impersonate_accountSwitch the active session to another account (agency/admin)1 cr
stop_impersonationEnd an account impersonation session1 cr
4 tools in Account / Session
Compatibility

Works with every MCP-compatible agent

If your agent speaks MCP, it can run paid advertising. No custom integrations needed.

Claude Code
Anthropic's coding agent
Anthropic
Claude Desktop
MCP-native desktop app
Anthropic
Cursor
AI-native code editor
IDE
Windsurf
Agentic IDE by Codeium
IDE
Hermes
Open-source AI agent framework
Open Source
Paperclip
Autonomous task agent
Open Source
OpenClaw
Open-source agent toolkit
Open Source
Any MCP Client
Standard protocol support
MCP
For Marketing Leaders

Why your marketing team needs an MCP server

The MCP server is the API — the 141 tools your AI agents call. MetadataONE is the product built on top of it: the specialist agents, the 60-second approval gate before any spend, the dashboards, and the asset library. Here is what that combination means for your demand gen operation.

1

Your team scales without new headcount

An MCP server lets AI agents do the repetitive campaign work your team does today: audience building, campaign setup, bid adjustments, reporting pulls. One agent can handle the workload of 2-3 junior media buyers. You redeploy your people to strategy.

2

Campaigns launch in minutes, not days

Today it takes your team 4-6 hours to launch a multi-channel campaign. With an MCP-connected agent, the same campaign goes from brief to live in under 10 minutes. Zoom cut their setup time by 94% using this exact approach.

3

24/7 optimization without overnight shifts

AI agents connected via MCP monitor performance, adjust bids, pause underperformers, and reallocate budget around the clock. Your team reviews results in the morning. The optimization happened while they slept.

4

You keep strategic control

The MCP server is the API, not a black box. In MetadataONE your team sets goals, approves budgets, and reviews every campaign plan before anything spends — the agents handle execution. Think of it as adding senior specialists who follow your playbook perfectly.

Your agents already think.
Now they can advertise.

See the MCP server in action, or dive straight into the developer docs.

Book a Demo Read the Docs

Frequently asked questions

What is the Metadata MCP server?

A Model Context Protocol server that exposes Metadata's tools to AI clients like Claude Code, so agents can build audiences, launch campaigns, and pull reporting headlessly.

How many tools does it expose?

141 MCP tools across audiences, campaigns, creative, offers, analytics, and operations.

Who is the MCP server for?

Developers and technical teams who want to run Metadata programmatically or from their own AI agents.