Metadata MCP - Supported Tools

Version: 2.0
Last Updated: January 13, 2026
Status: Public Documentation

Table of Contents

• 1. Overview
• 2. Tools by Category
• 3. Authentication & Authorization
• 4. Tool Specifications

Overview

The Metadata MCP Server exposes 75+ tools across 16 different categories, providing comprehensive access to marketing analytics, campaign management, audience targeting, and creative asset generation capabilities. This documentation serves as the complete reference for all available tools.

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