Metadata MCP Connector
Server Details
Connect Metadata to AI assistants for B2B advertising performance reports, audience planning, brand-aware creative, and campaign launch-readiness checks. Uses secure OAuth with an existing Metadata account and appropriate connected-channel permissions. Hosted Streamable HTTP endpoint maintained by Metadata Inc.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 179 tools
Many clusters of near-sibling tools make selection hard: roughly fifteen audience-creation tools (create_firmographic_audience, create_bombora_audience, create_technographic_audience, three G2 variants, three LinkedIn/Meta native criteria variants, four upload/list variants), and a dozen analytics readers (performance_metrics vs account_level_stats vs deep_funnel_stats vs experiment_performance_stats vs get_insights_report vs query_metadata_analytics_account). Pairs like get_audience_details vs get_deep_audience_details, and discover_features vs get_metadata_capabilities, have genuinely unclear boundaries despite long descriptions. To its credit, descriptions often include explicit WHEN TO USE / WHEN NOT TO USE guidance, which lifts this above a 1.
The dominant pattern is snake_case verb_noun (create_campaign, list_segments, archive_audience), but it is broken in several places: noun-only analytics tools (performance_metrics, account_level_stats, deep_funnel_stats, website_engagement_stats), compound verbs (create_update_image_ad, add_and_edit_campaign_elements), and inconsistent verb synonyms (get_ vs fetch_ vs retrieve_; list_ vs search_). Still readable and mostly predictable, but not a single consistent convention.
179 tools is an extreme mismatch for any single MCP surface, far beyond the 25+ 'too many' threshold. Much of the bulk is combinatorial repetition (eight create_google_*_extension tools, seven create_microsoft_*_extension tools, per-channel ad builders) that could be collapsed with a type parameter. The volume itself is a primary source of misselection risk.
Coverage is genuinely broad and lifecycle-aware: campaigns (create, duplicate, launch, pause/restart, archive/unarchive, readiness check), ads (create/update per channel, archive/unarchive, remove from campaign), audiences (create many types, archive/unarchive, list/get), keywords, negative keyword lists, extensions, UTMs, budget groups, integrations, credits, and brand assets. Remaining gaps are minor: no update-audience, no budget-group delete, no extension edit/delete from the library, and no segment update/delete.
Available Tools
179 toolsaccount_funnel_reportsGet Account Funnel Stage ReportsCRead-onlyInspect
Account-level funnel performance across stages.
Inputs: endDate (required), reportTab (required), startDate (required), page, +3 more.
account_level_statsGet Account-Level StatisticsCRead-onlyInspect
Account-level statistics and channel breakdown for a timeframe.
Inputs: endDate, startDate, timeframe.
account_list_performanceGet Account List PerformanceCRead-onlyInspect
Account list information with engagement metrics and statistics.
Inputs: page, size, sort, endDate, +2 more.
add_and_edit_campaign_elementsAdd & Edit Campaign ElementsADestructiveInspect
Add audiences, ads, offers, or targeting and edit supported settings of a Precision Optimization campaign. Returns the updated configuration and per-operation results or errors. Campaign structure and current platform state constrain which edits are permitted. LinkedIn ads can be added as named Metadata platform ad groups (ads.groups) when the user asks for them. CRITICAL: PARTIAL EDITS ONLY. Only campaignId is required. Supply other fields only for the user's requested changes, never by copying the whole campaign read result. A budget-group-only move uses campaign_data={"campaignId": 12345, "budgetGroup": "Destination"}. Omit name, startDate, endDate and channel blocks unless the user also requested those edits. Campaign-level startDate/endDate writes apply to every channel, including switched-off channels, so replaying a campaign's aggregate dates can overwrite distinct channel dates. On a draft, sending one date keeps the other as saved; when the saved one cannot stay (a start date already passed, an end before the new start, channels saved with different dates) nothing changes and errors says which date to ask the user for. For a budget-only move, read the campaign before and after and verify each channel's startDate/endDate and enabled state are unchanged, alongside the new budget group. The handler returns budget_move_verification for a completed move without date or channel edits. verified=true confirms every channel's identity, dates and switch state and the destination group. verified=false also populates errors: stop further moves and report the changed fields or incomplete readback, even when success=true because the budget group already changed. No schedule rollback is attempted. Do not report dates preserved without that readback; report any mismatch explicitly.
Inputs: campaign_data (required).
add_and_edit_native_campaign_elementsAdd & Edit Campaign Elements — Native / Channel-First (N×N×N)DestructiveInspect
Add or edit channel containers and campaign-level settings of a Channel First campaign. Returns the updated configuration and per-operation results or errors. Search-channel containers can combine keyword groups, audiences, ads, and offers subject to platform validation. CRITICAL: PARTIAL EDITS ONLY. Only campaignId is required. Supply other fields only for the user's requested changes, never by copying the whole campaign read result. A budget-group-only move uses campaign_data={"campaignId": 12345, "budgetGroup": "Destination"}. Omit name, startDate, endDate and channel blocks unless the user also requested those edits. Campaign-level startDate/endDate writes apply to every channel, including switched-off channels, so replaying a campaign's aggregate dates can overwrite distinct channel dates. On a draft, sending one date keeps the other as saved; when the saved one cannot stay (a start date already passed, an end before the new start, channels saved with different dates) nothing changes and errors says which date to ask the user for. For a budget-only move, read the campaign before and after and verify each channel's startDate/endDate and enabled state are unchanged, alongside the new budget group. The handler returns budget_move_verification for a completed move without date or channel edits. verified=true confirms every channel's identity, dates and switch state and the destination group. verified=false also populates errors: stop further moves and report the changed fields or incomplete readback, even when success=true because the budget group already changed. No schedule rollback is attempted. Do not report dates preserved without that readback; report any mismatch explicitly.
Inputs: campaign_data (required).
add_extensions_to_native_campaignAdd Extensions to Native-Structure CampaignInspect
Attach existing library extensions (sitelinks, callouts, etc.) to a native-structure Google Ads / Microsoft Ads campaign, so they actually serve when the campaign launches. A Google Ads Performance Max campaign does not use image, business logo or business name extensions, so those are refused there, and a Google Ads Display campaign takes no extensions at all.
Inputs: channel (required), campaign_id (required), extension_ids (required).
add_keywords_to_negative_listsAdd Keywords to Negative ListsBInspect
Add keywords to one or more existing Google Ads negative keyword lists.
Inputs: keywords (required), negativeListIds (required), channel, match_type.
add_negative_keyword_lists_to_live_campaignsAdd Negative Keyword Lists to Live CampaignsAInspect
Attach existing Google Ads negative keyword lists to campaigns that are ALREADY LAUNCHED. a live edit that syncs through to Google.
Inputs: campaignIds (required), mode, channel, listIds, +1 more.
archive_adArchive AdBDestructiveInspect
Archive (soft-delete) one or more ads on the Metadata platform.
Inputs: ids (required).
archive_audienceArchive AudienceADestructiveInspect
Archive a custom audience by ID. Returns the platform operation result or an error. Archived audiences are no longer available for new targeting.
Inputs: audience_name, custom_audience_id.
archive_campaignsArchive CampaignsBDestructiveInspect
Archive one or more campaigns, with a result per campaign.
Inputs: campaign_ids (required).
budget_group_performanceGet Budget Group PerformanceARead-onlyInspect
Read performance statistics for a budget group identified by name. The tool resolves the group ID internally and returns one page of experiment performance data with the available pagination metadata. Page size is capped at 100.
Inputs: budget_group_name (required), page, size, sort, +3 more.
check_campaign_launch_readinessCheck Campaign Launch ReadinessRead-onlyInspect
Check whether a draft campaign is ready to launch, per channel. Reads the campaign's real configuration from the platform and reports, for each ENABLED channel, whether it has the ads, audience, offer, budget AND a live channel connection it needs to go live, plus a specific list of blockers for anything missing. Enabled Facebook/Instagram video creatives need a saved Meta video_id in their creative; a later library upload does not repair a creative saved without one. A Google Ads Performance Max channel is also checked for what its asset group needs on Google, each blocker naming its fix: a daily budget of at least 10; one asset group with a Performance Max ad, a landing page offer and an audience signal; the ad's rules; a usable copy on Google Ads of every image, logo and video of a completed ad; the signal's limits and live audiences; and a Performance Max bid strategy with its target. A check that cannot read something blocks until it can.
Inputs: campaign_id (required).
clear_default_ma_listClear Default Marketing Automation ListADestructiveInspect
Clear the account’s default marketing-automation destination list for future campaign-channel creation. Existing channels retain their captured values. Returns status CLEARED with listId, provider, and name set to null, or an error.
Inputs: no named parameters.
connect_channelConnect ChannelAInspect
Create an OAuth authorization URL for the selected advertising channel. Returns url and state for the account owner to complete the provider authorization flow; for LinkedIn it also returns next_step, because the user may still need to choose the ad account and campaign group after signing in. Returning the URL does not establish a connection; check it afterwards with get_integrations_status. External callers must supply acknowledge_data_access=true for the requested credential grant; otherwise the server refuses the call.
Inputs: channel (required), acknowledge_data_access.
connect_crmConnect CRMAInspect
Create an OAuth authorization URL for the selected CRM. Returns a redirect URL for the account owner to complete the provider authorization flow. Returning the URL does not establish a connection. External callers must supply acknowledge_data_access=true for the requested credential grant; otherwise the server refuses the call.
Inputs: crm (required), acknowledge_data_access.
create_audience_from_segmentCreate Audience from SegmentAInspect
Create a dynamic Insights Retargeting audience from a saved Insights (Spotlight) segment: the companies matching the segment inside a lookback window, refreshed automatically as the journey data changes.
Inputs: name (required), segment_id (required), lookback_window (required), audience_type.
create_bombora_audienceCreate Bombora AudienceAInspect
Create Bombora buyer intent audiences on the Metadata platform. Creates B2B audiences based on buyer intent topics, company firmographics, contact attributes, and geographic targeting.
IMPORTANT PREREQUISITE:
Before using this tool, call get_intent_topics first to verify that Bombora topics are available.
If get_intent_topics returns NO topics (empty list), Bombora is NOT available for this account —
do NOT suggest or use this tool. Instead, recommend creating a firmographic audience
(create_firmographic_audience) as the preferred alternative.
Firmographic audiences are the default and most commonly used audience type.
WHEN TO USE:
- ONLY after get_intent_topics confirms that Bombora topics are available
- Create targeted B2B audiences based on buyer intent signals using Bombora data
- Target companies by industry, size, and employee count
- Target contacts by seniority level and job function
- Target specific buyer intent topics (e.g., Pardot, Salesforce)
- Set geographic targeting and contact limits per company
BUYER INTENT TOPICS:
Use the get_intent_topics tool to retrieve available intent topics before creating the audience.
Intent topics represent buyer interest areas such as:
- CRM solutions (e.g., Pardot, Salesforce)
- Marketing automation platforms
- Analytics and BI tools
- And many others based on available topics
TARGETING OPTIONS:
- Intent Topics: Use topic values from get_intent_topics (required for Bombora audience)
- Industries: Use industry IDs. Examples:
1=Defense & Space, 4=Computer Software, 6=Internet, 7=Semiconductors, 8=Telecommunications,
11=Management Consulting, 12=Biotechnology, 41=Banking, 42=Insurance, 43=Financial Services,
80=Marketing & Advertising, 96=Information Technology & Services
- Employees: "FROM_1_TO_10", "FROM_10_TO_50", "FROM_50_TO_200", "FROM_200_TO_500", "FROM_500_TO_1000", "FROM_1000_TO_5000", "FROM_5000_TO_10000", "OVER_10000"
- Job Function / Seniority / Job Title / Location: the same contact-criteria fields as the Firmographic and G2 tools (below), so the same criteria carry across audience types.
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS: Valid job function IDs and their labels:
1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS: Valid seniority IDs and their labels:
2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
8: Senior, 9: Owner, 10: Entry, 11: Partner
seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
Job titles are free text strings, not IDs
Use include parameters to specify which criteria to target
Use exclude parameters to filter out contacts matching specific criteria
Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
location_country_ids: Array of country IDs (optional)
location_state_ids: Array of state IDs (optional)
job_title_includes: Array of job title keywords to include (optional)
job_title_excludes: Array of job title keywords to exclude (optional)
job_function_include_ids: Array of job function IDs (optional)
job_function_exclude_ids: Array of job function IDs (optional)
seniority_include_ids: Array of seniority level IDs (optional)
seniority_exclude_ids: Array of seniority level IDs (optional)
contacts_per_company_limit: Maximum contacts per company (optional)
Returns audience details with ID, size estimation, and creation status.
Inputs: name (required), topics (required), employees, industries, +9 more.
create_budget_groupCreate or Update Budget GroupADestructiveInspect
Create or update a budget group with its channel, metric, allocation, and budget settings. This can affect advertising spend and requires confirm_budget_impact=true for the supplied settings; otherwise returns requires_confirmation and proposed_changes without writing. An id selects an existing group for update. Data containing only id and monthlyCap changes the monthly cap alone: it preserves the group's saved optimization, dates, funnels and campaigns and returns budget_update_verification; report success only when verified is true, and stop without retrying when it is false. New groups default autoApplyBudget to false; explicit autoApplyBudget=true allows the platform to apply the configured budget automatically. On create, omitting autoPauseConfigurationId uses the account's default auto pause rule set; on update, omitting it keeps the current one, and a different rule set must be one listed by get_budget_group. Returns the group or a validation/platform error.
Inputs: data (required), confirm_budget_impact.
create_campaignCreate Campaign — Precision Optimization (1×1×1)Inspect
Create a draft campaign using Precision Optimization (1x1x1), with a separate experiment for each configured audience, ad, and offer combination. Supports LinkedIn, Facebook, Instagram, Google Ads, Reddit, Microsoft Ads, and X (Twitter: image ads and landing page offers only; launching needs X connected, and a launched X campaign is view-only). Ads are attached individually through ads.list; ads.groups creates named Metadata platform ad groups only when the user asks for them, each with at least two distinct compatible ads (the same ad type on LinkedIn) and a name of at most 50 characters. Returns the draft campaign and channel configuration or validation errors. This tool does not launch it.
Inputs: campaign_data (required).
create_csv_upload_linkedin_native_audienceCreate CSV Upload - LinkedIn Native AudienceCInspect
Create a CSV Upload - LinkedIn Native audience (platform customAudienceType=NATIVE_TARGETING_CSV).
Inputs: audience_name (required), skills, revenues, companies, +5 more.
create_facebook_native_criteria_audienceCreate Facebook Native Criteria AudienceBInspect
Create a Facebook native criteria audience using Facebook-supported targeting criteria. Build audiences based on Facebook native industries, geographic location, job titles, interests, and age range.
Inputs: name (required), max_age (required), min_age (required), countries, +4 more.
create_firmographic_audienceCreate Firmographic AudienceAInspect
Create B2B company firmographic audiences for targeted advertising campaigns. Build audiences based on company attributes (industry, size, revenue) and contact-level criteria.
ESTIMATE-ONLY MODE:
Pass estimate_only=true to preview audience size (companies + contacts) WITHOUT creating the audience.
In this mode the tool returns expectedNumberOfCompanies,
expectedNumberOfContacts, and cappedContactCount. Default is false (audience is created).
PREFERRED AUDIENCE TYPE:
This is the DEFAULT and most commonly used audience type on the Metadata platform.
When the user asks to create an audience without specifying a type, prefer this tool.
Only suggest Bombora audiences if get_intent_topics returns available topics.
Only suggest G2 audiences if G2 is confirmed as connected via get_integrations_status
and the user specifically requests G2 targeting.
ALSO KNOWN AS: company audience, target companies, B2B audience, business targeting, account-based audience, ABM list, company targeting
WHEN TO USE:
- Default choice when the user wants to create a B2B audience
- Create targeted B2B audiences for LinkedIn, Facebook campaigns
- Target companies by industry, size, revenue
- Target contacts by seniority level and job function
- Set geographic targeting and contact limits per company
TARGETING OPTIONS:
- Industries: Use industry IDs. Examples:
1=Defense & Space, 4=Computer Software, 6=Internet, 7=Semiconductors, 8=Telecommunications,
11=Management Consulting, 12=Biotechnology, 41=Banking, 42=Insurance, 43=Financial Services,
80=Marketing & Advertising, 96=Information Technology & Services, more values in detail in the input schema
- Employees: "0 - 9", "10 - 49", "50 - 199", "200 - 499", "500 - 999", "1,000 - 4,999", "5,000 - 9,999", "10,000+"
- Revenue: "$1M - $10M", "$10M - $50M", "$50M - $100M", "$100M - $200M", "$500M - $1B", "$1B+"
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS: Valid job function IDs and their labels:
1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS: Valid seniority IDs and their labels:
2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
8: Senior, 9: Owner, 10: Entry, 11: Partner
seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
Job titles are free text strings, not IDs
Use include parameters to specify which criteria to target
Use exclude parameters to filter out contacts matching specific criteria
Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
location_country_ids: Array of country IDs (optional)
location_state_ids: Array of state IDs (optional)
job_title_includes: Array of job title keywords to include (optional)
job_title_excludes: Array of job title keywords to exclude (optional)
job_function_include_ids: Array of job function IDs (optional)
job_function_exclude_ids: Array of job function IDs (optional)
seniority_include_ids: Array of seniority level IDs (optional)
seniority_exclude_ids: Array of seniority level IDs (optional)
contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS: - name: Audience name (required) - **IMPORTANT: Name MUST NOT exceed 50 characters. This is a mandatory requirement.** - industries: Array of industry IDs (optional) - employees: Array of employee count ranges (optional) - revenue: Array of revenue ranges (optional) RETURNS: Audience details with ID, size estimation, and creation status. COMMON USE CASES: - Target software companies with 50-500 employees - Find companies in specific industries with revenue ranges - Build audiences with contact-level filtering (seniority, job function, location) - Combine firmographic and contact criteria for precise B2B targeting IMPORTANT NOTES: - **CRITICAL: Audience name MUST NOT exceed 50 characters - this is mandatory and will cause creation to fail if exceeded** - name is the only required parameter - All other parameters are optional for flexible audience creation - Contact criteria fields work the same as in G2 metadata dynamic audiences - Audience size depends on firmographic filters and applied contacts criteria
Inputs: name (required), revenue, employees, industries, +10 more.
create_g2_intent_dynamic_audienceCreate G2 Intent (Dynamic) AudienceAInspect
Create a G2 Intent (Dynamic) audience (platform customAudienceType=DYNAMIC_G2_CONTACT).
AUDIENCE TYPE (mirrors the UI's "Audience Type" dropdown):
• UI label: "G2 Intent (Dynamic)"
• Platform enum: DYNAMIC_G2_CONTACT
• Refreshes daily as G2 intent signals update; uses generic contact criteria (not LinkedIn-native).
PREREQUISITE:
• G2 integration MUST be connected. If not, do NOT call this tool — recommend `create_firmographic_audience`.
WHEN TO USE (exact user phrasing this tool should match):
• "G2 Intent (Dynamic)" (without "LinkedIn Native")
• "G2 intent dynamic audience"
• "Dynamic G2 audience"
• The user wants G2 intent that refreshes daily on Facebook/LinkedIn/other channels (not specifically LinkedIn-native).
WHEN NOT TO USE:
• If the user said "LinkedIn Native" → use `create_g2_intent_linkedin_native_dynamic_audience`.
• If the user said "Static" → use `create_g2_intent_static_audience`.
BUYING STAGES — REQUIRED BY THE PLATFORM:
Same as the LinkedIn Native variant: ASK the user if missing. DO NOT default.
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS: Valid job function IDs and their labels:
1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS: Valid seniority IDs and their labels:
2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
8: Senior, 9: Owner, 10: Entry, 11: Partner
seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
Job titles are free text strings, not IDs
Use include parameters to specify which criteria to target
Use exclude parameters to filter out contacts matching specific criteria
Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
location_country_ids: Array of country IDs (optional)
location_state_ids: Array of state IDs (optional)
job_title_includes: Array of job title keywords to include (optional)
job_title_excludes: Array of job title keywords to exclude (optional)
job_function_include_ids: Array of job function IDs (optional)
job_function_exclude_ids: Array of job function IDs (optional)
seniority_include_ids: Array of seniority level IDs (optional)
seniority_exclude_ids: Array of seniority level IDs (optional)
contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS: • name (required, ≤ 50 chars) • intent_days (required, 1-365) • buying_stages (REQUIRED by platform — ask if missing) • Contact criteria as in CONTACTS CRITERIA above. RETURNS: id, audience_id, audience_name, audience_type (DYNAMIC_G2_CONTACT), status, buying_stages, intent_days, counts.
Inputs: name (required), intent_days (required), buying_stages, job_title_excludes, +8 more.
create_g2_intent_linkedin_native_dynamic_audienceCreate G2 Intent - LinkedIn Native (Dynamic) AudienceBInspect
Create a G2 Intent - LinkedIn Native (Dynamic) audience (platform customAudienceType=DYNAMIC_G2).
Inputs: name (required), intent_days (required), skills, revenues, +5 more.
create_g2_intent_static_audienceCreate G2 Intent (Static) AudienceAInspect
Create a G2 Intent (Static) audience (platform customAudienceType=G2_ABM_CONTACT).
AUDIENCE TYPE (mirrors the UI's "Audience Type" dropdown):
• UI label: "G2 Intent (Static)"
• Platform enum: G2_ABM_CONTACT
• SNAPSHOT at creation time — does NOT refresh daily.
PREREQUISITE:
• G2 integration MUST be connected.
WHEN TO USE (exact user phrasing this tool should match):
• "G2 Intent (Static)"
• "Static G2 audience"
• The user explicitly wants the static / snapshot variant rather than the daily-refreshing dynamic one.
WHEN NOT TO USE:
• If the user said "Dynamic" → use `create_g2_intent_dynamic_audience` or `create_g2_intent_linkedin_native_dynamic_audience`.
BUYING STAGES — REQUIRED BY THE PLATFORM:
ASK the user if missing. DO NOT default.
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS: Valid job function IDs and their labels:
1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS: Valid seniority IDs and their labels:
2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
8: Senior, 9: Owner, 10: Entry, 11: Partner
seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
Job titles are free text strings, not IDs
Use include parameters to specify which criteria to target
Use exclude parameters to filter out contacts matching specific criteria
Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
location_country_ids: Array of country IDs (optional)
location_state_ids: Array of state IDs (optional)
job_title_includes: Array of job title keywords to include (optional)
job_title_excludes: Array of job title keywords to exclude (optional)
job_function_include_ids: Array of job function IDs (optional)
job_function_exclude_ids: Array of job function IDs (optional)
seniority_include_ids: Array of seniority level IDs (optional)
seniority_exclude_ids: Array of seniority level IDs (optional)
contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS: • name (required, ≤ 50 chars) • intent_days (required, 1-365) • buying_stages (REQUIRED — ask if missing) • Contact criteria as in CONTACTS CRITERIA above. RETURNS: id, audience_id, audience_name, audience_type (G2_ABM_CONTACT), status, buying_stages, intent_days, counts.
Inputs: name (required), intent_days (required), buying_stages, job_title_excludes, +8 more.
create_google_business_logo_extensionCreate Google Ads Business Logo Extension (BETA)AInspect
Create a business logo extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: image_library_id (required), domain_name, business_name.
create_google_callout_extensionCreate Google Ads Callout ExtensionAInspect
Create a callout extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: callout_text (required).
create_google_image_extensionCreate Google Ads Image Extension (BETA)AInspect
Create a image extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: image_library_ids (required), display_text, destination_url, alternative_text.
create_google_lead_form_extensionCreate Google Ads Lead Form ExtensionAInspect
Create a lead form extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: headline (required), business_name (required), privacy_policy_url (required), call_to_action_type (required), +9 more.
create_google_price_extensionCreate Google Ads Price ExtensionAInspect
Create a price extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: price_offerings (required), price_qualifier (required).
create_google_promotion_extensionCreate Google Ads Promotion ExtensionAInspect
Create a promotion extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: url (required), item (required), end_date (required), occasion (required), +7 more.
create_google_sitelink_extensionCreate Google Ads Sitelink ExtensionAInspect
Create a sitelink extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: url (required), link_text (required), description1 (required), description2 (required).
create_google_structured_snippet_extensionCreate Google Ads Structured Snippet ExtensionAInspect
Create a structured snippet extension in the account’s Google Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: header (required), values (required).
create_keywordsCreate KeywordsAInspect
Create one or more positive keywords in the Metadata platform library.
Inputs: keywords (required).
create_linkedin_engagement_retargeting_audienceCreate LinkedIn Engagement Retargeting AudienceCInspect
Create a LinkedIn Engagement Retargeting audience: people who already engaged with the advertiser's LinkedIn ads, company page, or website.
Inputs: name (required), source_platform (required), engagement_trigger (required), lookback_window_days (required), +3 more.
create_linkedin_native_criteria_audienceCreate LinkedIn Native Criteria AudienceBInspect
Create a LinkedIn native criteria audience using LinkedIn-supported targeting criteria. Build audiences based on job titles, skills, company names, employee count ranges, revenue ranges, and geographic location.
Inputs: name (required), skills, revenues, employees, +4 more.
create_marketing_automation_contacts_audienceCreate Marketing-Automation Contacts AudienceAInspect
Create a Marketing-Automation-contacts custom audience (platform customAudienceType MA_CONTACTS_STATIC or MA_CONTACTS_DYNAMIC) from a provider library list.
Inputs: variant (required), provider (required), library_list_id (required), custom_audience_name (required), +1 more.
create_microsoft_business_logo_extensionCreate Microsoft Ads Business Logo Extension (BETA)AInspect
Create a business logo extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: image_library_id (required), domain_name, business_name.
create_microsoft_callout_extensionCreate Microsoft Ads Callout ExtensionAInspect
Create a callout extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: callout_text (required).
create_microsoft_image_extensionCreate Microsoft Ads Image Extension (BETA)BInspect
Create a image extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: image_library_ids (required), display_text, destination_url, alternative_text.
create_microsoft_price_extensionCreate Microsoft Ads Price ExtensionAInspect
Create a price extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: price_offerings (required), price_qualifier (required).
create_microsoft_promotion_extensionCreate Microsoft Ads Promotion ExtensionAInspect
Create a promotion extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: url (required), item (required), end_date (required), occasion (required), +7 more.
create_microsoft_sitelink_extensionCreate Microsoft Ads Sitelink ExtensionAInspect
Create a sitelink extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: url (required), link_text (required), description1 (required), description2 (required).
create_microsoft_structured_snippet_extensionCreate Microsoft Ads Structured Snippet ExtensionAInspect
Create a structured snippet extension in the account’s Microsoft Ads asset library using the supplied fields. Returns the extension result and available identifier, or a validation/platform error. Attaching the extension to a campaign is a separate operation.
Inputs: header (required), values (required).
create_native_structure_campaignCreate Campaign — Channel First / Native Structure (N×N×N)Inspect
Create a draft campaign using Channel First Structure (NxNxN), also called Native Structure. Audiences, ads, and offers are grouped within channel-specific containers. Returns the draft campaign and channel configuration or validation errors. This tool does not launch it.
Inputs: campaign_data (required).
create_negative_keywords_listCreate Negative Keywords ListCInspect
Create a new negative keywords list in the Metadata platform with Google Ads integration.
Inputs: name (required), keywords (required), match_type (required), channel.
create_reddit_target_groupCreate Reddit Target GroupAInspect
Create a Reddit target group with location, communities, interests, or keyword criteria and optional audience references. Returns the group or validation/platform errors. The first include block contains location criteria with isModifiable=false.
Inputs: name (required), targeting (required).
create_retargeting_audienceCreate Retargeting AudienceCInspect
Create a new retargeting audience on the Metadata platform from native channel audiences.
Inputs: audience_data (required).
create_salesforce_contacts_audienceCreate Salesforce Contacts AudienceAInspect
Create a Salesforce-contacts custom audience (platform customAudienceType SFDC_CONTACTS_STATIC or SFDC_CONTACTS_DYNAMIC) from a Salesforce mixed-criteria.
Inputs: name (required), variant (required), criteria_id (required).
create_segmentCreate SegmentAInspect
Create a saved Insights segment from typed criteria over account-journey records. Returns the segment ID, name, status, and available account count. Invalid fields, operators, or values return validation errors; criteria groups support up to three nested group levels.
Inputs: name (required), criteria (required), lookback_window.
create_target_groupCreate Target GroupAInspect
Create a LinkedIn target group with a name, include rules, and optional exclusions. Criteria and audience references are validated against the account and channel. Returns the group or validation/platform errors.
Inputs: name (required), channel (required), targeting.
create_technographic_audienceCreate Technographic AudienceAInspect
Creates B2B audiences based on technology stack, software usage, and firmographic attributes.
ESTIMATE-ONLY MODE:
Pass estimate_only=true to preview audience size (companies + contacts) WITHOUT creating the audience.
In this mode the tool returns expectedNumberOfCompanies,
expectedNumberOfContacts, and cappedContactCount. Default is false (audience is created).
WHEN TO USE:
- Target companies using specific technologies or software
- Create audiences based on technology adoption patterns
- Target by technology categories (CRM, Marketing Automation, Analytics, etc.)
- Combine technology targeting with firmographic filters
- Build tech-savvy audience segments for B2B campaigns
- User wants to target companies and contacts that are familiar/using some specific software like hubspot, g2, etc.
TECHNOLOGY CATEGORIES:
- CRM: Salesforce, HubSpot, Microsoft Dynamics, Zoho, Pipedrive
- Marketing Automation: Marketo, Pardot, Eloqua, HubSpot, Mailchimp
- Analytics: Google Analytics, Adobe Analytics, Mixpanel, Amplitude
- E-commerce: Shopify, Magento, WooCommerce, BigCommerce
- Content Management: WordPress, Drupal, Joomla, Adobe Experience Manager
- Collaboration: Slack, Microsoft Teams, Zoom, Asana, Monday.com
- Cloud Infrastructure: AWS, Azure, Google Cloud, Oracle Cloud
- Database: MySQL, PostgreSQL, MongoDB, Oracle, SQL Server
- And many more technology categories available
FIRMOGRAPHIC FILTERS (OPTIONAL):
- Industries: Use industry IDs (1-148, same as firmographic audiences)
- Employees: "LESS_THAN_10", "FROM_10_TO_50", "FROM_50_TO_200", "FROM_200_TO_500", "FROM_500_TO_1000", "FROM_1000_TO_5000", "FROM_5000_TO_10000", "OVER_10000"
- Revenue: "LESS_THAN_1M", "FROM_1M_TO_10M", "FROM_10M_TO_50M", "FROM_50M_TO_100M", "FROM_100M_TO_200M", "FROM_200M_TO_500M", "FROM_500M_TO_1000M", "OVER_1000M"
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS: Valid job function IDs and their labels:
1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS: Valid seniority IDs and their labels:
2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
8: Senior, 9: Owner, 10: Entry, 11: Partner
seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
Job titles are free text strings, not IDs
Use include parameters to specify which criteria to target
Use exclude parameters to filter out contacts matching specific criteria
Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
location_country_ids: Array of country IDs (optional)
location_state_ids: Array of state IDs (optional)
job_title_includes: Array of job title keywords to include (optional)
job_title_excludes: Array of job title keywords to exclude (optional)
job_function_include_ids: Array of job function IDs (optional)
job_function_exclude_ids: Array of job function IDs (optional)
seniority_include_ids: Array of seniority level IDs (optional)
seniority_exclude_ids: Array of seniority level IDs (optional)
contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS: - name: Audience name (required) - **IMPORTANT: Name MUST NOT exceed 50 characters. This is a mandatory requirement.** - technologies: Array of technology names (required) - industries: Array of industry IDs (optional) - employees: Array of employee count ranges (optional) - revenue: Array of revenue ranges (optional) RETURNS: Audience details with ID, size estimation, and creation status, plus `technologies_requested`, `technologies_targeted` (the indexed names actually sent) and `technology_resolution`. COMMON USE CASES: - Target companies using Salesforce and HubSpot - Find AWS users in the software industry - Build audiences of companies using specific MarTech stacks - Combine technology and firmographic targeting for precise B2B campaigns IMPORTANT NOTES: - **CRITICAL: Audience name MUST NOT exceed 50 characters - this is mandatory and will cause creation to fail if exceeded** - name and technologies are required parameters - All other parameters are optional for flexible audience creation - Technology names are resolved against the platform's indexed product catalog: an exact name is used as given; otherwise the closest indexed match is used and reported back in `technology_resolution` (requested, used, exact_match, alternatives) plus a plain-words `technology_note`. A name with no catalog match fails the call with an error; nothing is dropped silently. - When the call fails as too small and the error names a substituted technology, retry with one of the listed alternatives or a broader technology name. Do NOT loosen industries, seniority, employee bands or countries first: the substituted product is the cause. - Contact criteria fields work the same as in other audience types - Audience size depends on technology filters and applied criteria
Inputs: name (required), technologies (required), revenue, employees, +11 more.
create_update_carousel_adCreate or Update Reddit Carousel AdADestructiveInspect
Create OR update a CAROUSEL ad on Reddit (Reddit only). TO UPDATE: include id; to CREATE: omit it.
Inputs: cards (required), adName (required), headline (required), id, +3 more.
create_update_convo_adCreate or Update LinkedIn Conversation AdCDestructiveInspect
Create or update a LinkedIn Conversation Ad ("convo ad"). a branching in-message chat where each step contains a message bubble and a list of button actions that drive the conversation forward.
Inputs: name (required), steps (required), senderId (required), senderName (required), +6 more.
create_update_ctv_adCreate or Update LinkedIn CTV (Connected TV) AdADestructiveInspect
Create OR update a LinkedIn CTV (Connected TV) video ad. LinkedIn only. TO UPDATE: include id; to CREATE: omit it.
Inputs: ads_data (required).
create_update_document_adCreate or Update LinkedIn Document AdCDestructiveInspect
Create a new or update an existing LinkedIn Document Ad on the Metadata platform.
Inputs: name (required), text (required), headline (required), libraryId (required), +4 more.
create_update_google_ads_adCreate or Update Google Ads AdADestructiveInspect
Create or update a Google Ads text ad. An id selects an existing ad for update. Headlines are limited to 30 characters and descriptions to 90; repeated copy is rejected. Returns the ad definition or a validation/platform error.
Inputs: name (required), headlines (required), descriptions (required), id.
create_update_image_adCreate or Update Image AdADestructiveInspect
Create OR update an IMAGE (or GIF, except on X) ad on Facebook, Instagram, LinkedIn, Reddit, and/or X. TO UPDATE: include id; to CREATE: omit it. An X ad that belongs to a launched campaign cannot be updated.
Inputs: ads_data (required).
create_update_linkedin_message_adCreate or Update LinkedIn Message AdCDestructiveInspect
Create a new or update an existing LinkedIn Message Ad on the Metadata platform.
Inputs: name (required), senderId (required), actionText (required), senderName (required), +5 more.
create_update_microsoft_ads_adCreate or Update Microsoft Ads AdADestructiveInspect
Create or update a Microsoft Ads text ad. An id selects an existing ad for update. Headlines are limited to 30 characters and descriptions to 90; repeated copy is rejected. Returns the ad definition or a validation/platform error.
Inputs: name (required), headlines (required), descriptions (required), id.
create_update_offerCreate or Update OfferADestructiveInspect
Create or update Lead Gen or Landing Page offers in Metadata platform. Returns direct URL to access the offer in the platform. Lead Gen form fields take only the channel's predefined field types; the account's custom questions go in customFieldSelections, copied from get_offer, and on update omitting customFieldSelections keeps the current ones. A form takes at most 12 fields and custom questions together, and this tool cannot create a new custom field.
Inputs: data (required), offer_type (required).
create_update_video_adCreate or Update Video AdADestructiveInspect
Create OR update a VIDEO ad on Facebook, Instagram, LinkedIn, and/or Reddit. TO UPDATE: include id; to CREATE: omit it. For Facebook and Instagram, every requested video must report READY on that channel before any ad is written; otherwise the whole batch is refused and nothing is created.
Inputs: ads_data (required).
deep_funnel_statsGet Deep Funnel Analysis StatisticsBRead-onlyInspect
Comprehensive funnel conversion analysis: funnel conversions, ROI statistics, experiment performance.
Inputs: funnel_id (required), endDate, startDate, opportunityModel.
delete_negative_keyword_listsDelete Negative Keyword ListsADestructiveInspect
Permanently delete one or more entire Google Ads negative keyword lists, only when the user has explicitly asked.
Inputs: listIds (required), channel.
demographic_country_statsGet Demographic Country StatisticsCRead-onlyInspect
Performance metrics grouped by Country.
Inputs: page, size, sort, toMonth, +3 more.
disconnect_channelDisconnect ChannelADestructiveInspect
Disconnect the selected advertising-channel integration from the current Metadata account. This changes the integration and can interrupt campaign management. Returns the platform operation result or an error. Reconnection requires a separate authorization flow.
Inputs: channel (required).
discover_featuresDiscover Metadata features to tryARead-onlyIdempotentInspect
Show which Metadata features this account already uses and which it has not tried yet, with personal recommendations and an example request for each. Read-only, and always about the account this connection is working in. Use when the user asks what else Metadata can do, what they are missing or have not tried, or for feature recommendations. Each feature has a status: in_use, tried, not_used, needs_connection (a channel or CRM must be connected first), not_in_plan (the account's plan or the user's permissions rule it out; never recommend these) or unknown (could not be read; do not call it unused). Usage comes from the account's platform records (basis platform) or, for features that leave no platform record, only from calls through Metadata's MCP connectors (basis mcp): for those, not_used means no such call, so never tell the user they have not used it in the Metadata app. why_for_you is specific to this account only when personal is true. Present the picks as short cards (name, what it does, why it fits them, the example request) and offer to run one.
Inputs: limit, domain, include_inventory. Returns: object
duplicate_campaignDuplicate CampaignBInspect
Duplicate (copy) an existing campaign into a NEW DRAFT campaign.
Inputs: campaign_id (required), name.
duplicate_negative_keywords_listDuplicate Negative Keywords List Across ChannelsAInspect
Duplicate (copy) a negative keyword list from one search channel to the other: Google Ads to Microsoft Ads (Bing), or Microsoft Ads to Google Ads.
Inputs: sourceListId (required), name, dryRun, sourceChannel, +1 more.
edit_brand_creativeEdit Brand CreativeAInspect
Create an AI-edited copy of an existing image using the supplied edit instructions and brand context. Returns a hosted URL for a new standalone image that the caller can download or use independently. The source image and any existing library creative remain unchanged. The new image is not automatically attached to an ad; upload_image_creative can store it under a new library ID. AI edits may alter text and visual details beyond the requested region.
Inputs: domain (required), image_source (required), edit_instruction (required).
estimate_target_groupEstimate Target GroupARead-onlyInspect
Estimate reach for LinkedIn or Reddit targeting criteria, including audience references and exclusions. Returns the match count and whether it falls below the channel minimum, or an error. This tool does not create a target group.
Inputs: channel (required), targeting.
experiment_performance_statsGet Experiment Performance StatisticsBRead-onlyInspect
Experiment-level performance statistics from Metadata.io Experiments API. Rows carry no lead or conversion date.
Inputs: name, page, size, sort, +21 more.
experiments_keywords_statsGet Keyword Performance Statistics from ExperimentsCRead-onlyInspect
Keyword performance data from active experiments with date range filtering.
Inputs: endDate (required), startDate (required), page, size, +2 more.
fetch_creative_detailsFetch Creative DetailsBRead-onlyInspect
Get detailed information for specific creative assets by their IDs. Looks up each creative ID individually.
Inputs: creative_id.
find_offer_urlFind Offer Landing-Page URLARead-onlyInspect
Find a specific marketing-offer landing page on a domain when no URL is already known. Checks conventional paths, the sitemap, and links on the site, then scores matching pages. Generic index pages and direct media/PDF links are excluded. Returns a candidate landing-page URL and discovery details, or success=false when no suitable page is found. It does not create or modify an offer.
Inputs: domain (required), offer_type (required), topic.
find_privacy_urlFind Privacy URLBRead-onlyInspect
Locate the privacy-policy URL for a given website domain.
Inputs: domain (required).
fix_flexible_creativeFix Flexible Creative ImageAInspect
Create an AI-edited copy of a supplied background or flat creative image, at the source's pixel size (longest edge at most 2000 px) when the shape is close to the source's. Returns a hosted URL for a new standalone image that the caller can download or use independently. It does not update the source, a library item, an ad, or the layered document. The first-party editor can use the returned URL as a replacement background. Registered brand characters shown in the source are kept unless characters is passed to change them. WARNING: text baked into a flat image may be repainted or become unreadable; separate text and logo layers are outside this tool's edit.
Inputs: domain (required), image_source (required), edit_instruction (required), characters.
generate_brand_creativeGenerate Brand CreativeAInspect
Generate a branded advertising image using AI and a company brand kit. The headline and optional CTA are baked into the pixels. Returns a hosted URL for a finished PNG that the caller can download or use independently. This tool does not automatically attach the image to an ad or launch a campaign; a separate upload_image_creative and ad-creation call can consume it. Missing brand data is generated by the tool. Text rendering may differ from the requested copy.
Inputs: domain (required), headline (required), instructions (required), logo_url, +6 more.
generate_brand_kitGenerate Brand KitBInspect
Analyze a company's brand from their website and extract brand identity. Fetch brand assets (logo, colors, fonts) and create a brand DNA document for consistent advertising.
Inputs: domain (required), brand_name, sample_ad_urls, force_regenerate.
generate_flexible_brand_creativeGenerate Flexible Brand CreativeAInspect
Generate a layered creative document with an AI-generated background and editable text, CTA, and logo layers, at the ad channel's recommended size for the chosen platform and aspect_ratio (a shape the channel does not take is refused). Returns JSON containing canvas dimensions, positions, styling, and a hosted background image URL. The background URL is a standalone asset that the caller can download or use independently; it is also referenced by the returned document. Optional reference_images (at most 12) guide the background without painting their text or logos. Optional art_direction sets the art direction of the background drafts, and direction_seed the mix they explore without one; provenance.quality records the direction that won (direction) and a fingerprint of the background as painted (background_fingerprint). The combined result is checked before return, and any warning is included in the document. No ad is automatically created or launched. Copy above the schema and canvas-specific limits is rejected with an error: headline 45 characters and 8 words on 1:1, 4:3, 4:5 and 9:16 canvases, 55 characters and 10 words on 16:9 and 1.91:1, or 35 characters and 6 words on the 6:5 banner; CTA wording that fits on one line of its button; subheadline 90 characters; label 24 characters.
Inputs: domain (required), instructions (required), cta, body, +15 more.
get_abm_account_listsGet ABM Account ListsBRead-onlyInspect
Get account lists from the Metadata ABM Lists library. Retrieves uploaded CSV account lists, website retargeting lists, and their metadata.
Inputs: page, size, sort, type, +2 more.
get_account_detailsGet Account DetailsCRead-onlyInspect
Current user and account information.
Inputs: no named parameters.
get_account_opportunities_insightsGet Account Opportunities InsightsBRead-onlyInspect
Get opportunities for domain(s) with status filtering and pagination.
Inputs: domains (required), page, size, sort, +3 more.
get_account_summary_insightsGet Account Summary InsightsCRead-onlyInspect
Get comprehensive account details for specific domain(s).
Inputs: domains (required).
get_account_utm_defaultsGet Account UTM DefaultsARead-onlyInspect
Read the account’s resolved UTM defaults by channel. Returns values and their origin, including platform defaults when no account-specific value exists. Empty stored mappings do not imply that tracking is disabled. Does not modify defaults.
TRACKING TIMING AND TOKEN MEANING: Leads using server-resolved campaign UTMs use the current saved mapping when the platform processes them, without waiting for an ad republish. Captured URL or caller-supplied values can follow a different ingestion path, so do not generalize this timing to every new lead. Native click-time macros retain values captured from the lead's click URL. Ad click URLs have a separate publication timeline: a draft uses the saved mapping at launch, and launched ads use it on their next campaign publish. Saving a launched Microsoft Ads campaign triggers a live UTM push. AD_NAME is a dynamic token, not necessarily an individual ad name: standard experiments use their ad group name when present, otherwise their creative name; native ad structures use the native ad's own name. CAMPAIGN_NAME uses the wizard campaign name. Saving a launched campaign can also queue an asynchronous existing-lead UTM refresh. Do not assume historical rows are immutable or that all old rows have already refreshed. Verify the saved mapping with get_campaign_utms and actual lead values and ingestion timing separately from live ad click URLs; a supplied or backfilled lead creation date alone does not prove when its UTMs were resolved.
Inputs: no named parameters.
get_ad_detailsGet Ad DetailsARead-onlyInspect
Read an advertising-library ad by ID. Returns its configuration, content, creative references, channel, and status as available from the platform, or an error when the ad is inaccessible. This is an ad definition, not an experiment performance report. Its status is the library status (active or archived), not whether the ad is on or off inside an ad set: list_experiment_ads gives that for the ad sets of given experiments or campaigns.
Inputs: ids (required).
get_audience_detailsGet Audience DetailsARead-onlyInspect
Custom audience information from Metadata platform: configurations, targeting criteria, size metrics, performance. A NAME IS REQUIRED: this is the by-name lookup, not the account-wide browse.
Inputs: name (required), page, size, sort.
get_brand_kitGet Brand KitARead-onlyInspect
Retrieve current brand kit configuration for a company, including its registered brand characters (characters[], each with a reference-sheet URL valid for one hour).
Inputs: domain (required).
get_budget_groupGet Budget GroupARead-onlyInspect
Get configuration and settings for a budget group (NOT performance data). Matches the full stored name across search pages, ignoring letter case and outer whitespace, whether switched on or off, and refuses ambiguous names. Also returns the account's auto pause rule sets (accountAutoPauseRuleSets). A MONTHLY_RESET or CUSTOM_RESET group runs until switched off; currentPeriodStart and currentPeriodEnd bound only the current period, not the group's end.
Inputs: name (required).
get_campaign_by_wizard_idGet Campaign by Wizard IDARead-onlyInspect
Get full campaign details by its wizard campaign ID, including channels, audiences, ads, and budget configuration.
Inputs: campaign_id (required).
get_campaign_targeting_locationsGet Campaign Targeting LocationsARead-onlyInspect
Read the configured geographic targeting of a campaign. Returns its targeting locations and channel details, and for native targeting the attached audienceIds, targetGroupIds and resolvedFrom. These are the locations the campaign is configured to target. An empty countries list is not evidence that no audience is attached, and targeting.resolved false means the geographic scope could not be fully read. demographic_country_stats reports where delivery occurred, which can differ from targeting.
Inputs: campaign_ids, country_names, max_campaigns.
get_campaign_utmsGet Campaign UTMsARead-onlyInspect
Read one wizard campaign’s resolved UTM parameters by channel. Returns stored and resolved values, origin, and comparison with account defaults. An empty stored mapping inherits the account defaults, or platform defaults when the account has none. A stored mapping identical to its inherited default cannot be distinguished from inheritance. Dynamic tokens are resolved for lead records and ad URLs, not stored as literal text. Does not modify UTMs.
TRACKING TIMING AND TOKEN MEANING: Leads using server-resolved campaign UTMs use the current saved mapping when the platform processes them, without waiting for an ad republish. Captured URL or caller-supplied values can follow a different ingestion path, so do not generalize this timing to every new lead. Native click-time macros retain values captured from the lead's click URL. Ad click URLs have a separate publication timeline: a draft uses the saved mapping at launch, and launched ads use it on their next campaign publish. Saving a launched Microsoft Ads campaign triggers a live UTM push. AD_NAME is a dynamic token, not necessarily an individual ad name: standard experiments use their ad group name when present, otherwise their creative name; native ad structures use the native ad's own name. CAMPAIGN_NAME uses the wizard campaign name. Saving a launched campaign can also queue an asynchronous existing-lead UTM refresh. Do not assume historical rows are immutable or that all old rows have already refreshed. Verify the saved mapping with get_campaign_utms and actual lead values and ingestion timing separately from live ad click URLs; a supplied or backfilled lead creation date alone does not prove when its UTMs were resolved.
Inputs: campaign_id (required).
get_converted_leads_summaryGet Converted Leads Summary (Smart Leads aggregates)ARead-onlyInspect
Read aggregate counts and rates for the account's converted leads using optional date, campaign, channel, and audience filters. Returns totals, MQL rates, unique leads and domains, channel mix, enrichment and marketing-automation coverage, and triggered/influenced opportunity aggregates where available. No individual lead rows are returned. This summary can establish a baseline for lead analysis; get_converted_leads provides paginated rows where access permits.
Inputs: ids, email, adName, syncMA, +24 more.
get_credit_balanceGet AI Credit BalanceARead-onlyInspect
Read the current AI credit balance for the authenticated account. Returns account_id, balance_usd, updated_at, and is_exhausted, or an error. When the account's direct use is not charged, the response also carries direct_use_charged=false and is_exhausted stays false. A negative balance is possible. An unreadable balance is unknown, not zero. Credit payments settle asynchronously, so a completed card charge can precede a usable balance. This tool does not initiate a purchase.
Inputs: no named parameters.
get_credit_transactionsGet AI Credit TransactionsARead-onlyInspect
Read paginated AI credit movements for the authenticated account, newest first. Negative amountUsd values are charges; positive values are top-ups or adjustments. Returns account_id, transactions with source, description, referenceId, createdAt and markup, plus total_elements, total_pages, and page. This tool does not initiate a purchase.
Inputs: page, size.
get_current_dateGet Current DateARead-onlyInspect
Return the REAL current date and time (UTC).
Inputs: no named parameters.
get_deep_audience_detailsGet Deep Audience DetailsCRead-onlyInspect
Get detailed information about audiences including criteria and advanced configuration.
Inputs: audience_ids (required).
get_default_ma_listGet Default Marketing Automation ListARead-onlyInspect
Read the account’s default marketing-automation destination list and its current health. Returns the stored list ID, name, provider, and status as available. The default applies to newly created campaign channels; existing channels retain the value captured when they were created.
Inputs: no named parameters.
get_insights_reportGet Insights ReportBRead-onlyInspect
Query account journey insights with filtering, sorting, and pagination.
Inputs: page, sort, endDate, criteria, +2 more.
get_integrations_statusGet Integrations StatusARead-onlyInspect
Read the authenticated account’s advertising-channel, CRM, and marketing-automation integration status. Returns the connected or disconnected state and available integration details. A LinkedIn connection can also report connectionPending (the ad account was not chosen yet, so it is not launch-ready even when connected is true) or reconnectRequired, each with an action_required message for the user. It does not authorize a new connection or disconnect an existing one.
Inputs: platformName.
get_intent_topicsGet Intent TopicsBRead-onlyInspect
Get available intent topics for BOMBOORA audience creation.
Inputs: no named parameters.
get_linkedin_engagement_source_typesGet LinkedIn Engagement Source TypesBRead-onlyInspect
List the LinkedIn engagement source types and their triggers.
Inputs: no named parameters.
get_matched_audiencesGet Matched AudiencesRead-onlyInspect
Get matched audiences (custom audiences) from the Campaign Wizard based on audience type and targeting options.
Inputs: page, size, sort, type, +2 more.
get_metadata_capabilitiesShow what Metadata can doARead-onlyIdempotentInspect
Show an interactive, business-level overview of what this Metadata connection can do for the user: planning and launching campaigns, reaching target accounts, creating ads, managing spend, measuring impact and connecting their stack, with example requests to try. Its discovery part is the account's feature adoption per area and a few features worth trying next, the same report discover_features gives without the per-feature list, read from the account this connection is working in. Call it when the user has just connected Metadata, asks what Metadata or this connector can do, or asks for help getting started. Changes nothing; it only shows what this user's permissions and the account's plan allow. A pick with status needs_connection needs that connection first. A pick with basis mcp is unused only through Metadata's MCP connectors, so never tell the user they have not used it in the Metadata app. why_for_you is specific to this account only when personal is true. Give adoption per area as in_use out of measured, the features whose use can be proved or ruled out.
Inputs: no named parameters. Returns: object
get_negative_keywords_list_detailsGet Negative Keywords List DetailsCRead-onlyInspect
Fetch the keywords inside a single Google Ads negative keyword list.
Inputs: listId (required), page, size, sort, +2 more.
get_offerGet OfferARead-onlyInspect
Get offer information by name or list all offers.
Inputs: name, offer_id.
get_payment_statusGet Payment StatusARead-onlyInspect
Read settlement status for one existing credit payment by reference_id. Returns pending or settled status, settled, amount_usd, settled_at, balance_usd, and is_exhausted. A card charge and a ledger credit occur asynchronously; amount_usd is null while pending. This tool does not initiate a purchase.
Inputs: reference_id (required).
get_retargeting_audiencesGet Retargeting AudiencesCRead-onlyInspect
Get all available retargeting audiences for a specific advertising channel.
Inputs: channel (required).
get_segment_criteriaGet Segment CriteriaARead-onlyInspect
Read one saved Insights segment by id or name: its criteria, status, and how many accounts it matches. Pass lookback_window to count inside the window an audience would use.
Inputs: segment_id, segment_name, lookback_window.
launch_campaignLaunch CampaignDestructiveInspect
Launch a configured campaign by ID. This can start advertising spend. With confirm_budget_impact omitted or false, returns requires_confirmation and proposed_changes without completing ads or launching the campaign. True asserts the caller's explicit authorization for this launch. After confirmation, the tool completes missing ad details and requests the platform launch; validation or platform errors are returned when launch cannot proceed. A Google Ads Performance Max campaign is refused while check_campaign_launch_readiness reports a blocker for it, because Google creates the campaign enabled and its asset group in a batch that is not atomic, so a refused asset group would leave a live campaign without one; completing a Performance Max draft ad sends its media to Google Ads, and the launch is refused until Google Ads has processed them. Provider acceptance is not proof that ads have begun delivering.
Inputs: campaign_id (required), confirm_budget_impact.
list_audiencesList AudiencesARead-onlyInspect
List the account's custom audiences, newest first: the same inventory the Metadata Audiences page shows.
Inputs: name, page, size, type.
list_budget_groupsList All Budget GroupsARead-onlyInspect
Browse and list budget groups in the Metadata platform with customizable sorting. Results are paginated and include switched-on and switched-off groups unless status is set; reading a switched-off group does not switch it on. A MONTHLY_RESET or CUSTOM_RESET group runs until switched off and its currentPeriodStart and currentPeriodEnd describe only the current period; only a FIXED_BUDGET group's endDate ends it.
Inputs: page, size, status, sort_by, +1 more.
list_experiment_adsList Experiment AdsARead-onlyInspect
List the ads inside launched experiments (ad sets), grouped by experiment, with each ad's status in that experiment as the Ads tab shows it, for every channel. Pass experiment_ids (experimentId from search_experiments), campaign_ids, or both (both keeps the given experiments that belong to the given campaigns), and optionally statuses, such as ["PAUSED"] for the ads that are off. status is what the channel last reported: ACTIVE (on), PENDING (on but not serving yet, such as in review, processing or before its start date), PAUSED (off), COMPLETED (ended, or no longer on the channel) or FAILED (the channel reports a problem, such as a disapproval, a deletion or an account hold). An ad switched off inside a running ad set reads PAUSED while the ads still on read ACTIVE. On LinkedIn and Meta a paused or ended ad set or campaign also makes all of its ads read PAUSED or COMPLETED, so compare with the experiment's own status (search_experiments). lastActionReason marks a pause of the ad made in Metadata: MANUAL_PAUSE (by a person) or LOW_PERFORMANCE (by the optimizer); MANUAL_PAUSE_PENDING or LOW_PERFORMANCE_PAUSE_PENDING means the channel has not confirmed that pause yet and the ad may still be running; MANUAL_PAUSE_FAILED means the pause failed and the ad keeps running. An ad with no impressions yet is listed with its own status like any other, so never infer an ad's status from zero impressions. When the call passed no statuses and complete is true, an ad in search_experiments' adIds that is missing here has no status in Metadata: either the channel has not reported it yet or it failed to launch (a SOME_ADS_LAUNCH_FAILED or, on LinkedIn, SOME_CREATIVES_LAUNCH_FAILED issue on the experiment in search_experiments points to the latter, though its absence does not rule a failed launch out), so say so and never report it as running or paused; with statuses, a missing ad may simply be in another status. statusLabel is the Ads tab's chip (Disapproved for an ad Google Ads disapproved, unless it is paused). This is not the library status get_ad_details and search_ads_by_names report. Returns at most 250 ads, newest experiments first; complete=false says some were left out and partial marks an experiment cut short. Read-only.
Inputs: statuses, campaign_ids, experiment_ids.
list_experiment_keywordsList Experiment KeywordsBRead-onlyInspect
Search and browse keywords running in experiments with simplified response data.
Inputs: keywordOrExperimentName (required), page, size.
list_extensionsList Search Ad ExtensionsARead-onlyInspect
List the account's Google Ads / Microsoft Ads library extensions (sitelinks, callouts, snippets, etc.) with their internal ids.
Inputs: channel (required), name, page, size, +1 more.
list_keywordsList KeywordsCRead-onlyInspect
List and search keywords with filtering, sorting, and pagination options.
Inputs: name, page, size, sort, +1 more.
list_linkedin_conversionsList LinkedIn ConversionsARead-onlyInspect
List the LinkedIn conversion actions (Insight Tag conversions) available on the connected LinkedIn ad account, with id, name, type and whether each is enabled.
Inputs: no named parameters.
list_marketing_automation_listsList Marketing-Automation ListsBRead-onlyInspect
List a Marketing-Automation provider's contact library lists. the selectable source for creating a Marketing-Automation-contacts audience.
Inputs: provider (required), name, list_type.
list_negative_keywords_listList Negative Keywords ListsCRead-onlyInspect
List and search negative keywords lists by name filter.
Inputs: name, channel.
list_salesforce_mixed_criteriaList Salesforce Mixed-CriteriaBRead-onlyInspect
List the account's saved Salesforce "mixed criteria" (contact-list criteria). the selectable source for creating a Salesforce-contacts audience.
Inputs: qualified.
list_search_termsList Search TermsCRead-onlyInspect
Review the Google Ads search terms report with filtering, sorting, and pagination.
Inputs: page, size, sort, channel, +6 more.
list_segmentsList SegmentsBRead-onlyInspect
List the account's saved Insights (Spotlight) account-journey segments: {id, name, status, last_update_date}.
Inputs: name, sort.
list_target_groupsList Target GroupsBRead-onlyInspect
List and search target groups in Metadata platform.
Inputs: name, sort.
list_user_accountsList User AccountsARead-onlyInspect
List accounts in the signed-in user's current memberships, optionally filtered by partial name or exact account ID. External connector callers, including Metadata staff, cannot search other accounts. Returns user_id, email, default_account_id, is_super_user, token_type, and accounts containing account_id, name, and role. Memberships are resolved using the original credential, not a switched account's PAT. Metadata's authenticated first-party admin interface separately supports scoped staff account search.
Inputs: name, account_id.
list_wizard_campaignsList Wizard CampaignsBRead-onlyInspect
List wizard (Metadata-native) campaigns for the current account with pagination, sorting, and experiment-status filtering.
Inputs: name, page, size, status, +4 more.
manage_campaignManage CampaignADestructiveInspect
Pause or restart a campaign by ID. Restart can resume advertising spend and requires confirm_budget_impact=true for the specified campaign. An omitted or false flag on restart returns requires_confirmation and proposed_changes without changing the campaign. Pause does not require that flag. Returns the platform operation result or a validation error.
Inputs: action (required), campaign_id (required), confirm_budget_impact.
manage_experimentManage ExperimentADestructiveInspect
Pause, restart or reactivate one launched experiment. reactivate runs a Completed experiment again until end_date (required, YYYY-MM-DD). Restart and reactivate can increase spending: they first estimate the impact on budget groups and, when a group is affected, return a confirmation request without acting until confirm_budget_impact=true. Returns the platform operation result or an error. Keyword-level pause or restart is a separate operation.
Inputs: action (required), experiment_id (required), end_date, confirm_budget_impact, +1 more.
pause_experiment_keywordPause Experiment KeywordCDestructiveInspect
Pause a specific keyword running in an experiment.
Inputs: wizExperimentId (required), keywordExternalId (required).
performance_metricsGet Performance MetricsARead-onlyInspect
Read paginated performance metrics for ads, audiences, creatives, offers, target groups, or keywords. The endpoint argument selects the report and dates use ISO 8601. Returns one page of metrics and available pagination metadata, with at most 100 rows.
Inputs: ids, page, size, sort, +36 more.
query_metadata_analytics_accountQuery Account AnalyticsARead-onlyInspect
Read a periodically refreshed summary of the authenticated account's firmographics and recent campaign history from the Metadata analytics warehouse. It is not a live platform-state query. The account ID is resolved from the credential and cannot be supplied by the caller; cross-account queries are refused. Returns a JSON envelope with status, text_reply, rows, SQL, confidence, applied_filters, and timing. LOW confidence with identity_only_rows means no substantive attributes were found; literal_only_result is not a warehouse result.
Inputs: question (required). Returns: result
query_metadata_analytics_benchmarksQuery Advertising BenchmarksARead-onlyInspect
Read cross-account cohort benchmarks from the Metadata analytics warehouse. Questions can describe an industry, size, channel, ad format, or audience cohort. Named-company queries and identity-bearing outputs are refused. Returns aggregate rows, text_reply, SQL, confidence, empty_reason, and timing, or a refusal/error envelope. LOW confidence with literal_only_result is not a warehouse benchmark.
Inputs: question (required), conversation_id. Returns: result
regenerate_flexible_backgroundRegenerate Flexible Creative BackgroundADestructiveInspect
Generate a new AI background for a layered creative, optionally using the current background as a reference. Returns a hosted URL for a standalone background image that the caller can download or use independently. The tool does not modify the document or attach the image to an ad; the first-party editor can use the returned URL to replace its background. Existing text and logo layers are unchanged. The supplied aspect_ratio determines the new image shape. Registered brand characters shown in the source are kept unless characters is passed to change them; a result that loses one is returned as an error.
Inputs: domain (required), instructions (required), platform, characters, +3 more.
register_brand_characterRegister Brand CharacterAInspect
Register a character the brand owns (a mascot, a team member, a recurring persona) so creatives can feature it faithfully, or replace the one of that name. Its images are cut out onto one reference sheet, the traits a viewer knows it by are read off them, and one test render is judged against those traits.
A brand keeps at most 5 characters. Before calling, confirm with the user that the brand owns the character or holds the rights and consent of the person shown, and pass rights_confirmed true. A real public figure (a celebrity, politician or historical figure) or hateful content is refused.
RETURNS: the stored character (name, traits, its own marks, style, and the test render's result: passed false names the traits it missed, so suggest clearer images), sheet_view_url (a link to show the user the character's reference sheet, valid for one hour) and the brand's character names.
Inputs: name (required), domain (required), image_urls (required), rights_confirmed (required), +1 more.
remove_ad_from_campaignRemove Ad from CampaignDestructiveInspect
Remove specific ads (ad groups) from one or more channels in an existing campaign. A launched campaign's X channel (TWITTER) is view-only, so removals there are refused, and a launched Google Ads Performance Max campaign keeps its asset group's ad, so that removal is refused too.
Inputs: campaign_id (required), channel_ads (required).
remove_audiences_from_campaignRemove Audiences from CampaignDestructiveInspect
Remove specific audiences from one or more channels in an existing campaign. A launched campaign's X channel (TWITTER) is view-only, so removals there are refused, and a launched Google Ads Performance Max campaign keeps the audiences of its audience signal, so that removal is refused too.
Inputs: campaign_id (required), channel_audiences (required).
remove_brand_characterRemove Brand CharacterADestructiveInspect
Remove a registered brand character from the brand kit by name. Creatives already made with it are unchanged.
Inputs: name (required), domain (required).
remove_channels_from_campaignRemove Channels from CampaignBDestructiveInspect
Disable one or more entire channels from an existing campaign.
Inputs: channels (required), campaign_id (required).
remove_extensions_from_native_campaignRemove Extensions from Native-Structure CampaignADestructiveInspect
Detach extensions from a native-structure Google Ads / Microsoft Ads campaign. The extension stays in the account library. only the campaign binding is removed.
Inputs: channel (required), campaign_id (required), extension_ids (required).
remove_keywords_from_campaignRemove Keywords from CampaignBDestructiveInspect
Remove Google Ads keyword groups and/or negative keyword list attachments from a campaign's GOOGLE_ADS channel.
Inputs: campaign_id (required), channel_id, channel_keywords, channel_negative_keyword_lists.
remove_keywords_from_negative_listRemove Keywords from Negative ListBDestructiveInspect
Remove keywords from a single existing Google Ads negative keyword list, matched by text.
Inputs: listId (required), keywords (required), channel.
remove_offers_from_campaignRemove Offers from CampaignADestructiveInspect
Remove offers. Lead Gen forms OR Landing Pages. from one or more channels in an existing campaign. A launched campaign's X channel (TWITTER) is view-only, so removals there are refused.
Inputs: campaign_id (required), channel_offers (required).
remove_target_groups_from_campaignRemove Targeting Groups from CampaignDestructiveInspect
Remove targeting groups from one or more channels in an existing campaign. A launched campaign's X channel (TWITTER) is view-only, so removals there are refused, and a launched Google Ads Performance Max campaign keeps its audience signal (its target group), so that removal is refused too.
Inputs: campaign_id (required), channel_target_groups (required).
resize_imageResize ImageAInspect
Make a resized copy of an image at an exact pixel size. Deterministic image processing: no AI model runs and nothing in the image is redrawn.
USE FOR: fitting an existing image (an uploaded file, a library creative, a creative made earlier) to a placement's size, e.g. LinkedIn 1200x628 or 1200x1200, Meta feed 1080x1080 or 1440x1800, Stories 1080x1920, display 300x250 or 728x90.
SIZE: give width and height for an exact size, or only one of them to scale proportionally. Each side is at most 4096 px.
WHEN THE SHAPE CHANGES (width and height given, in an aspect ratio other than the source's), fit decides:
pad (default): keeps the whole image, scaled to fit inside the target, and fills the empty bands with
background. Nothing is cut off or distorted.crop: scales the image to cover the target and trims the overflow, keeping the part named by
crop_focus. WARNING: text, logos or faces near the trimmed edges are lost.stretch: scales each side independently. Distorts the image; use it only when asked to. A source within 1% of the target's shape is scaled straight to the exact size.
DOES NOT: redesign or re-lay out a creative for a new shape, change the source image, or save anything to the creatives library.
OUTPUT: the URL of a NEW image (s3_url), stored temporarily outside the creatives library, with its image_size, the source's source_size, fit_applied (none when the shape was kept), the pad's background, upscaled (true when the source was enlarged, which cannot add detail and looks softer) and format. To use it in an ad, upload the URL with upload_image_creative, which gives it a NEW library id.
Inputs: image_source (required), fit, width, height, +3 more.
resolve_linkedin_ad_library_linksResolve LinkedIn Ad Library Links to Metadata AdsARead-onlyInspect
Map LinkedIn Ad Library links (linkedin.com/ad-library/detail/), sponsoredCreative URNs or bare LinkedIn creative ids to the ads in this account's Metadata library, so an ad the user points at by its LinkedIn link can be REUSED in a new campaign instead of rebuilt.
Inputs: links (required), max_pages, campaign_ids.
restart_experiment_keywordRestart Experiment KeywordBDestructiveInspect
Restart a specific paused keyword in an experiment.
Inputs: wizExperimentId (required), keywordExternalId (required).
retrieve_target_group_by_idRetrieve Target Group by IDARead-onlyInspect
Get detailed target group information by ID.
Inputs: target_group_id (required).
search_ads_by_namesSearch Ads by NameARead-onlyInspect
Search for ads by name in the Metadata platform library, with pagination. An ad's status here is its library status (active or archived); list_experiment_ads gives whether it is on or off inside the ad sets of given experiments or campaigns.
Inputs: ad_names (required), page, size, sort, +1 more.
search_campaigns_by_namesSearch Campaigns by NameARead-onlyInspect
Find wizard campaigns by partial case-insensitive names. Returns matching campaign IDs, names, statuses, and available configuration details. This resolves a campaign name to an ID for later reads or authorized changes; it does not launch or modify a campaign.
Inputs: campaign_names (required).
search_campaigns_by_utm_valueSearch Campaigns By UTM ValueBRead-onlyInspect
Find wizard campaign channels whose resolved UTM parameters contain a specified value. Returns matching campaigns, channels, values, and origin information with pagination. Inherited account or platform values are included; a stored mapping identical to its inherited default cannot be distinguished from inheritance.
TRACKING TIMING AND TOKEN MEANING: Leads using server-resolved campaign UTMs use the current saved mapping when the platform processes them, without waiting for an ad republish. Captured URL or caller-supplied values can follow a different ingestion path, so do not generalize this timing to every new lead. Native click-time macros retain values captured from the lead's click URL. Ad click URLs have a separate publication timeline: a draft uses the saved mapping at launch, and launched ads use it on their next campaign publish. Saving a launched Microsoft Ads campaign triggers a live UTM push. AD_NAME is a dynamic token, not necessarily an individual ad name: standard experiments use their ad group name when present, otherwise their creative name; native ad structures use the native ad's own name. CAMPAIGN_NAME uses the wizard campaign name. Saving a launched campaign can also queue an asynchronous existing-lead UTM refresh. Do not assume historical rows are immutable or that all old rows have already refreshed. Verify the saved mapping with get_campaign_utms and actual lead values and ingestion timing separately from live ad click URLs; a supplied or backfilled lead creation date alone does not prove when its UTMs were resolved.
Inputs: utm_value (required), name, page, size, +5 more.
search_experiment_recipesSearch Campaign RecipesARead-onlyInspect
Search aggregate historical campaign configurations by channel, format, audience type, and bid strategy. Returns recipes, tabular columns and rows, confidence, and suppressed_below_k. Results describe historical configurations, not guaranteed outcomes or the current account's performance. Named-company queries are refused and small cohorts are suppressed.
Inputs: query (required), channel, ad_format, num_results, +2 more. Returns: result
search_experimentsSearch ExperimentsARead-onlyInspect
Search for experiments (ad sets) by name, status, and budget group with flexible filtering. adIds lists an experiment's ads without their status, and the SOME_ADS_INACTIVE issue does not say which ads are off: call list_experiment_ads with the experimentId for each ad's status in the ad set.
Inputs: page, size, sort, search_name, +2 more.
search_insights_criteria_fieldsSearch Insights Criteria FieldsARead-onlyInspect
Discover the fields an Insights (Spotlight) account-journey segment can filter on: the exact field names, their type, the operators each accepts, and the picklist options.
Inputs: search_keywords.
search_library_creatives_by_nameSearch Creative Library (Images, Videos, GIFs, Documents)Read-onlyInspect
Search or list creative assets in the library by name, across ALL content types. images, videos, GIFs and documents. Returns detailed information about matching assets with pagination support, including each asset's width, height, sizeInKb and content_type. The shape and size filters find media for a Google Performance Max ad: contentTypes IMAGE with aspectRatios 1.91 for landscape, 1 for square, 0.8 for portrait, or 1 and 4 for logos, maxSizeInKb 5120 and visibilities VISIBLE (contentTypes VIDEO for its videos). The filter matches ratios within 2% while the Performance Max ad holds them to 1%, so check width and height before using a result.
Inputs: page, size, sort, minWidth, +6 more.
search_linkedin_engagement_sourcesSearch LinkedIn Engagement SourcesBRead-onlyInspect
Find which LinkedIn campaigns or pages to retarget, for a chosen engagement source type.
Inputs: engagement_source_type (required), limit, search, engagement_trigger, +1 more.
search_ma_listsSearch Marketing Automation ListsARead-onlyInspect
Search destination lists in the connected marketing-automation integration by name. Returns lists containing listId and name. An empty array indicates no matching list or no connected integration. List IDs belong to this account and can be used by set_default_ma_list.
Inputs: name (required).
search_reddit_criteriaSearch Reddit Target Group CriteriaARead-onlyInspect
Get available Reddit targeting criteria and their reference values (externalId + name) for target group creation.
Inputs: criteria_type (required), search_terms.
search_target_group_criteriaSearch Target Group CriteriaARead-onlyInspect
Get available criteria and their supported values (names and IDs) for target group creation/updates.
Inputs: channel (required), exact_match, search_terms, criteria_type, +1 more.
set_campaign_utmsSet Campaign UTMsADestructiveInspect
Set or clear the UTM parameters for one channel of a wizard campaign, merging the supplied changes into the existing mapping. Returns the updated tracking settings or an error. Clearing a stored mapping restores inheritance from the account or platform defaults; it does not disable tracking. Account-level defaults remain unchanged. A saved mapping applies to incoming server-resolved leads immediately; publishing ad click URLs follows a separate timeline.
TRACKING TIMING AND TOKEN MEANING: Leads using server-resolved campaign UTMs use the current saved mapping when the platform processes them, without waiting for an ad republish. Captured URL or caller-supplied values can follow a different ingestion path, so do not generalize this timing to every new lead. Native click-time macros retain values captured from the lead's click URL. Ad click URLs have a separate publication timeline: a draft uses the saved mapping at launch, and launched ads use it on their next campaign publish. Saving a launched Microsoft Ads campaign triggers a live UTM push. AD_NAME is a dynamic token, not necessarily an individual ad name: standard experiments use their ad group name when present, otherwise their creative name; native ad structures use the native ad's own name. CAMPAIGN_NAME uses the wizard campaign name. Saving a launched campaign can also queue an asynchronous existing-lead UTM refresh. Do not assume historical rows are immutable or that all old rows have already refreshed. Verify the saved mapping with get_campaign_utms and actual lead values and ingestion timing separately from live ad click URLs; a supplied or backfilled lead creation date alone does not prove when its UTMs were resolved.
Inputs: utms (required), channel (required), campaign_id (required).
set_default_ma_listSet Default Marketing Automation ListAInspect
Set the account’s default marketing-automation destination list by a resolved list_id from search_ma_lists. The default affects newly created campaign channels; existing channels retain their captured values. Returns the updated setting or a failure such as PERMISSION_DENIED or DISCONNECTED. Account marketing-automation write access is required.
Inputs: list_id (required).
set_landing_subdomainSet Landing Page SubdomainADestructiveInspect
Set the account’s generated landing-page subdomain once. Returns the claim status or a validation error. Existing claims cannot be changed or released through this tool; an empty subdomain is rejected.
Inputs: subdomain (required).
set_search_channel_final_url_suffixSet Final URL Suffix on a Search ChannelADestructiveInspect
Set or clear the Final URL Suffix on a wizard campaign's search channel (Google Ads or Microsoft Ads). The suffix is appended to every final URL the platform serves. typically UTM parameters for tracking (utm_source, utm_medium, utm_campaign, ...).
Inputs: channel (required), campaign_id (required), final_url_suffix (required).
set_search_channel_locationsSet Geo Targeting on a Search ChannelBDestructiveInspect
Set the geographic targeting of a wizard campaign's search channel (Google Ads or Microsoft Ads). which countries/states the campaign serves in, and which countries to exclude.
Inputs: channel (required), campaign_id (required), states, countries, +1 more.
unarchive_adUnarchive AdAInspect
Unarchive (restore) one or more previously archived ads.
Inputs: ids (required).
unarchive_audienceUnarchive AudienceBInspect
Restore an archived custom audience by ID. Returns the platform operation result or an error.
Inputs: audience_name, custom_audience_id.
unarchive_campaignsUnarchive CampaignsBInspect
Put archived campaigns back, with a result per campaign.
Inputs: campaign_ids (required), confirm_pending_launch_ids.
update_brand_kitUpdate Brand KitCDestructiveInspect
Update existing brand kit with brand DNA parameters. Only company_url is required; all others are optional.
Inputs: company_url (required), dos, tone, donts, +75 more.
update_experiment_end_dateUpdate Experiment End DateADestructiveInspect
Move the end date of ONE running Google Ads or Microsoft Ads experiment, leaving the campaign's other experiments as they are.
KEYWORDS: experiment, end date, extend, shorten, schedule, stop date, run until
WHEN TO USE:
- User wants experiment X to run until a later or earlier date
- User wants to change one experiment's end date without touching the rest of its campaign
WHAT THE PLATFORM ALLOWS:
- Google Ads and Microsoft Ads experiments that are running (Active): this tool.
- A Completed experiment, any channel: manage_experiment(action="reactivate",
end_date=...), which runs it again until that date.
- A LinkedIn, Facebook, Instagram or Reddit experiment: the platform moves its
end date only campaign-wide (add_and_edit_campaign_elements or
add_and_edit_native_campaign_elements, which move every experiment of that
campaign). This tool refuses them and changes nothing.
- A Paused experiment: its end date moves only while it runs; restart it
(manage_experiment) only if the user wants it running again.
- Google Ads re-applies the experiment's saved countries and states with the
date, so the tool refuses Performance Max, an experiment that excludes
locations, and one with no saved countries or states.
PARAMETERS:
- experiment_id: experimentId from search_experiments
- end_date: YYYY-MM-DD, today or later and within a year; the experiment runs
through that day
RESULT:
status="submitted" means the change was sent: the channel applies it in the
background, and search_experiments shows the new end date once the channel
confirms. Say it was requested, not that it changed, until a read shows it.
status="unchanged" means it already ended on that date and nothing was sent.
success=false comes with an error that says why nothing was changed.
WARNING: This changes the live schedule of the experiment on the ad channel.Inputs: end_date (required), experiment_id (required).
update_experiments_daily_budgetsUpdate Experiments Daily BudgetsADestructiveInspect
Update daily budgets for the specified experiment IDs, including live experiments. Requires confirm_budget_impact=true for these exact amounts; otherwise returns requires_confirmation and proposed_changes without writing. Values accept numbers or decimal strings using a dot or comma and are normalized to two decimal places. Returns the platform update result or validation errors.
Inputs: budgets (required), confirm_budget_impact.
update_linkedin_channel_settingsUpdate LinkedIn Channel SettingsADestructiveInspect
Update the LinkedIn channel settings of an existing DRAFT wizard campaign: native objective, bidding optimization goal (including Reach), bid strategy with manual bid amount, and the LinkedIn conversion actions the campaign optimizes toward.
Inputs: campaign_id (required), objective, bid_amount, bid_strategy, +2 more.
update_meta_placementsUpdate Meta Placements (Facebook / Instagram)ADestructiveInspect
Set the channel-level Meta placement default of an existing DRAFT wizard campaign's Facebook or Instagram channel: automatic placements (Meta decides where ads serve) or a manual list of surfaces (Feed, Stories, Reels, ...).
Inputs: mode (required), channel (required), campaign_id (required), placements.
update_reddit_channel_settingsUpdate Reddit Channel SettingsADestructiveInspect
Update the Reddit channel settings of an existing DRAFT wizard campaign: native objective, allow comments, placements (feed/conversations), conversion pixel, and (for manual-bid objectives) the bid amount.
Inputs: campaign_id (required), objective, bid_amount, placements, +2 more.
update_target_groupUpdate Target GroupADestructiveInspect
Update a LinkedIn target group by ID. Name is required, and a targeting update supplies the complete include and exclude configuration. Returns the updated group or an error. Existing targeting omitted from a replacement can be removed.
Inputs: name (required), target_group_id (required), targeting.
upload_account_list_csv_audienceUpload Account List CSV and Create AudienceAInspect
Create a firmographic audience from company account records, supplied inline or through a CSV URL, with optional contact-targeting filters. Company rows contain companyname and companywebsite; this is not the personal-contact upload endpoint. Returns the audience creation result or validation errors; matching occurs asynchronously.
Inputs: audience_name (required), companies, job_title_excludes, job_title_includes, +8 more.
upload_contact_list_csv_audienceUpload Contact List CSV and Create Contact List AudienceAInspect
Create a contact-list audience from either inline contacts over the authenticated MCP connection or a private, expiring CSV URL. Exactly one source is required. Signed URLs must use S3/GCS signatures or an Azure read-only HTTPS SAS, expire within one hour of issue, and refer to an object inaccessible without its signature. Public URLs and redirects are rejected.
The CSV header is exactly email,firstname,lastname,jobtitle,employeecompany,country,appleidfa,googleaid (case-insensitive and whitespace-trimmed). Email is required; other columns can be blank. Accepts 300 to 300,000 contacts. The server validates the file and uploads it through the platform's upload flow. Returns the audience creation result and ID or validation errors. Audience readiness and channel matching occur asynchronously.
Inputs: audience_name (required), contacts, contacts_source_csv_url.
upload_document_creativeUpload Document CreativeBInspect
Upload PDF documents to the Metadata platform library so they can be promoted as LinkedIn Document Ads. Downloads each PDF from its URL and uploads it to the platform library as a DOCUMENT asset.
Inputs: documents (required), names.
upload_image_creativeUpload Image CreativeAInspect
Download images from the supplied URLs and upload them to the Metadata creative library. Returns library asset IDs and image information, or upload errors. This does not create or launch an ad.
Inputs: images (required), names.
upload_video_creativeUpload Video CreativeInspect
Upload videos directly to the Metadata platform library to create video creatives. Downloads videos from provided URLs and uploads them to the platform. Success means the library accepted the file; Meta uploads continue asynchronously, so read per-channel status with fetch_creative_details before creating a Facebook or Instagram video ad. A standard upload (no usage_type) also serves a Google Performance Max ad, which sends the video to Google Ads when that ad is saved as completed.
Inputs: videos (required), usage_type, thumbnail_library_id.
website_engagement_statsGet Website Engagement StatisticsCRead-onlyInspect
Website visitor engagement metrics: session data, page views, visitor behavior analytics.
Inputs: dateRange (required), page, size, sort.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRemote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.MIT
- AlicenseCqualityCmaintenanceCompetitor Monitor AI - MCP server providing AI-powered tools and automation by MEOK AI Labs112 npm46 PyPIMIT
- AlicenseAqualityDmaintenanceEnables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.1611 npm1MIT

industrylens-mcpofficial
AlicenseNot gradedqualityCmaintenanceBrowse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.