Metadata MCP - Supported Tools

Overview

Key Features

• Model Context Protocol (MCP): Full MCP 2.0 specification compliance
• Dynamic Tool Registration: Tools are dynamically loaded from various integrations
• Enterprise-Grade Authentication: PAT tokens and JWT-based session management
• Comprehensive API Coverage: Full access to Metadata.io and Make.com integrations

Tools by Category

1. Campaign Management

Tool Name	Description	Type
create_campaign	Create multi-channel marketing campaigns (LinkedIn, Facebook, Instagram, Google Ads)	Destructive
launch_campaign	Launch draft campaigns to begin live advertising with real budget spend	Destructive
manage_campaign	Pause or restart campaigns	Destructive
search_campaigns_by_names	Search campaigns by name to get IDs and status	Read-Only
add_elements_to_campaign	Add audiences, ads, offers, keywords to existing campaigns	Destructive
add_exclusion_audiences_to_campaign	Add exclusion audiences to campaigns	Destructive

2. Budget & Financial Management

Tool Name	Description	Type
create_budget_group	Create or update budget groups with spending caps and optimization goals	Destructive
get_budget_group	Get budget group configuration and settings	Read-Only
budget_group_performance	Get performance statistics for specific budget groups	Read-Only
list_budget_groups	List all budget groups with customizable sorting	Read-Only
update_experiments_daily_budgets	Update daily budget allocations for experiments	Destructive

3. Audience Building

Tool Name	Description	Type
create_firmographic_audience	Create B2B audiences based on firmographics (industry, size, revenue)	Destructive
create_technographic_audience	Create audiences based on technology stack usage	Destructive
create_bombora_audience	Create buyer intent audiences using Bombora data	Destructive
create_g2_metadata_dynamic_audience	Create G2 buyer stage audiences (Awareness, Consideration, Decision)	Destructive
create_retargeting_audience	Create retargeting audiences from native channel data	Destructive
create_audience_from_segment	Create custom audience from insights segment	Destructive
get_audience_details	Get detailed audience information	Read-Only
get_deep_audience_details	Get comprehensive audience criteria and configuration	Read-Only
get_matched_audiences	Get custom audiences matching targeting criteria	Read-Only
get_retargeting_audiences	Get available retargeting audiences by channel	Read-Only

4. Target Groups

Tool Name	Description	Type
create_target_group	Create new target group with targeting criteria	Destructive
estimate_target_group	Estimate audience size before creating target group	Read-Only
update_target_group	Update existing target group name and criteria	Destructive
list_target_groups	List and search available target groups	Read-Only
retrieve_target_group_by_id	Get detailed target group configuration by ID	Read-Only
search_target_group_criteria	Search available targeting criteria (industries, seniority, job titles)	Read-Only

5. Creative & Ad Management

Tool Name	Description	Type
create_update_ads	Create or update ads across channels (LinkedIn, Facebook, Instagram)	Destructive
search_ads_by_names	Search ads by name in the library	Read-Only
get_ad_details	Get complete ad details and configuration by ID	Read-Only
generate_brand_creative	Generate branded marketing images using AI	Destructive
edit_brand_creative	Edit existing creative images with AI	Destructive
generate_brand_kit	Generate comprehensive brand kit (colors, fonts, logos, guidelines)	Destructive
get_brand_kit	Retrieve current brand kit configuration	Read-Only
update_brand_kit	Update brand kit with custom colors, fonts, logos	Destructive
upload_image	Upload images to Metadata platform	Destructive
search_library_images_by_name	Search creative library by image name	Read-Only
fetch_creative_details	Get metadata for specific creative assets	Read-Only

6. Offers & Lead Gen

Tool Name	Description	Type
create_update_offer	Create or update Lead Gen forms or Landing Page offers	Destructive
get_offer	Get offer details by name	Read-Only

7. Keywords Management

Tool Name	Description	Type
create_keywords	Batch create positive keywords for campaigns	Destructive
create_negative_keywords_list	Create negative keywords list for Google Ads	Destructive
list_keywords	List and search keywords with filtering and pagination	Read-Only
list_negative_keywords_list	List negative keywords lists by name	Read-Only

8. Experiments & Performance

Tool Name	Description	Type
experiment_performance_stats	Get detailed experiment-level performance metrics	Read-Only
search_experiments	Search experiments by name, status, and budget group	Read-Only
experiments_keywords_stats	Get keyword performance data from experiments	Read-Only
performance_metrics	Get granular metrics for ads, audiences, creatives, offers, keywords	Read-Only

9. Account Insights & Attribution

Tool Name	Description	Type
get_account_summary_insights	Get comprehensive account summary (engagement, pipeline, revenue)	Read-Only
get_account_timeline_insights	Get chronological activity timeline with touchpoints	Read-Only
get_account_conversions_insights	Get conversion/people data for accounts	Read-Only
get_account_opportunities_insights	Get opportunity data with status filtering	Read-Only
get_insights_report	Query account journey insights with advanced filtering	Read-Only
search_insights_criteria_fields	Discover available fields for building insight filters	Read-Only

10. Segments

Tool Name	Description	Type
create_segment	Create new segment with filtering criteria	Destructive
list_segments	List all segments or search by name	Read-Only
get_segment_criteria	Retrieve full criteria for a segment	Read-Only

11. Funnel & Analytics

Tool Name	Description	Type
account_funnel_reports	Get account funnel performance (Reached, Engaged, Converted, MQL, Opps, Won)	Read-Only
account_level_stats	Get account statistics by period and channel	Read-Only
account_list_performance	Get account list engagement and pipeline metrics	Read-Only
deep_funnel_stats	Get comprehensive funnel conversion analysis	Read-Only
demographic_country_stats	Get performance metrics by country/geography	Read-Only
website_engagement_stats	Get website visitor engagement metrics	Read-Only

12. Integrations & Connections

Tool Name	Description	Type
connect_channel	Get OAuth URL to connect advertising channels (LinkedIn, Meta, Google, Reddit, X)	Destructive
disconnect_channel	Disconnect advertising channel integration	Destructive
connect_crm	Get OAuth URL to connect CRM (Salesforce, HubSpot)	Destructive
get_integrations_status	Get connection status for all channels and CRM systems	Read-Only

13. ABM & Account Lists

Tool Name	Description	Type
get_abm_account_lists	Get account lists from ABM library	Read-Only

14. Intent Topics

Tool Name	Description	Type
get_intent_topics	Get available Bombora intent topics for audience creation	Read-Only

Authentication & Authorization

Supported Authentication Methods

• Personal Access Token (PAT): Token-based authentication for API access
• JWT Session Management: Session-based authentication for web applications
• OAuth 2.0: For third-party integrations (channels and CRM systems)

Authorization Scopes

All tools respect user permissions and account-level access controls.

Tool Specifications

Data Safety Classification

• Read-Only Tools: Query and retrieve data without making modifications (44 tools)
• Destructive Tools: Create, update, or delete data; may incur costs (31 tools)

Best Practices

• Always use read-only tools first to validate data before destructive operations
• Estimate audience sizes before creating target groups or audiences
• Search for existing campaigns/ads/audiences before creating new ones
• Use search tools to find IDs needed for update/delete operations
• Review budget allocations before launching campaigns