Status: Closed Beta — Tools and capabilities are subject to change as the beta progresses. This reference reflects the current tool set.
Important: New tools are added to the Agent Connector on a regular basis, and this documentation may not always reflect the very latest additions. Your AI agent automatically discovers all available tools when it connects to the MCP server, so we recommend periodically asking your agent what tools are currently available to ensure you're taking advantage of the latest capabilities.
The Infillion Agent Connector exposes 50+ tools that AI agents can discover and invoke. Each tool includes built-in documentation, parameter schemas, and contextual guidance that helps the AI agent understand when and how to use it.
Tools are organized into the following functional areas. Within each area, tools follow consistent patterns: find_* tools for search/discovery, get_*_info tools for detailed inspection, and action-specific tools for create/update operations.
Confirms MediaMath API availability, latency, and connection health. Use this as a first step to verify connectivity before running other operations.
Use when: Validating the platform is responsive, diagnosing connectivity issues, or confirming readiness before batch workflows.
Searches campaigns with comprehensive filters including advertiser, agency, organization, date ranges, goal type, status, and more. Returns compact summaries by default; use full=true for complete campaign objects or extended=true for strategy context. Supports pagination for large result sets (up to 25 per call).
Key filters: advertiser_id, agency_id, organization_id, status, goal_type, date ranges (created_on, start_date, end_date), name (partial match)
Retrieves a single campaign's full configuration including budgets, pacing, goals, frequency settings, flight schedules, attribution, and identity settings. Use extended=true to include strategy IDs and MFA inheritance.
Creates a new campaign under a specified advertiser. Requires at minimum: advertiser ID, campaign name, and goals configuration. Supports full configuration of budgets, flights, pacing, frequency, attribution, and inventory settings.
Applies partial updates to an existing campaign's settings. Only specified fields are modified; omitted fields remain unchanged.
Searches strategies with filters for campaign, advertiser, pacing, goals, supply type, media type, and targeting flags. Supports full and extended modes for detailed payloads.
Key filters: campaign_id, advertiser_id, agency_id, status, goal_type, media_type, supply_type, pacing_type
Retrieves comprehensive strategy configuration including pacing, goals, inventory, and targeting details. Use extended=true for audience/contextual group details and full targeting breakdowns.
Creates a new strategy under an existing campaign. Requires campaign ID, strategy name, and goal configuration. Supports full configuration of pacing, frequency, budget, inventory (exchanges, deals, site lists), targeting (audience, contextual, geo, daypart, technology), and creative assignments.
Business rules:
goal_typecannot beroiorcpaunlessuse_optimizationis true and a merit pixel is set on the parent campaign.spendgoal type is only supported whenuse_optimizationis false.
Applies partial updates to an existing strategy. Supports modification of all strategy fields including goals, pacing, targeting, inventory, and creative assignments.
Searches atomic creatives (the base creative object for display, video, and native) with filters for advertiser, concept, dimensions, format, approval status, file type, and more.
Key filters: advertiser_id, concept_id, ad_format, width/height, approval_status, media_type, file_type
Retrieves a single atomic creative's full configuration including dimensions, tags, approval status, click-through URL, and metadata.
Returns a focused preview of an atomic creative with visual properties, dimensions, ad tag, and preview URL. A lighter alternative to full info when only preview details are needed.
Checks exchange approval status for display and video creatives across advertising exchanges (AppNexus, Google AdX, MoPub, Microsoft Ad Exchange, etc.). Returns per-exchange approval status and net health.
Accepts: Single creative ID or array of up to 100 IDs for bulk checking.
Searches native (component) creatives with filters for advertiser, organization, status, and text search. Native creatives contain component assets like title, body, images, and videos.
Retrieves detailed information for a single native creative including all component assets, clickthrough URLs, concept information, and optional preview data.
Checks approval status for native/component creatives across advertising sources. Use this instead of atomic_creative_healthcheck for native creatives.
Retrieves detailed information for a single video creative including duration, encoding status, VAST version, security status, companion ads, event pixels, and vendor information.
Bulk fetches video creative details for an array of creative IDs (1–100 per call).
Creates a new Third Party Ad Served (3PAS) video creative. Requires advertiser ID, creative name, concept ID, and either inline VAST XML or a VAST URL.
Applies partial updates to an existing video creative. Supports both T1AS and 3PAS creatives.
Searches concepts by advertiser, status, or name. Concepts group creatives together and are referenced by strategies.
Note: "Creative group" and "concept" are interchangeable terms in MediaMath.
Retrieves concept metadata including advertiser ownership and attached creative/strategy associations.
Flexible query tool for the MediaMath Reporting API V2. Supports the performance dataset and custom datasets. Returns results as JSONL-style rows.
Required: At least one dimension/metric field, at least one filter (typically org_id or campaign_id), and a time specification (time_window or start_time).
Rollup options: all, by_day, by_week, by_month
Dedicated tool for hourly performance metrics using the performance-hourly dataset. Automatically applies by_hour rollup. Optimized for intraday pacing analysis, time-of-day optimization, and delivery troubleshooting.
Time windows: current_day, yesterday, last_24_hours, last_48_hours, last_7_days, last_30_days, month_to_date, or custom start/end times.
Queries the all-dimensions-and-metrics dataset — the widest set of available dimensions in a single report. Ideal for ad-hoc analysis, QBR exports, CPA/supply/creative deep-dives, and multi-pivot exports.
Queries auction metrics before a win or bid has taken place, broken out by strategy, exchange, and deal dimensions. Use for bid rate optimization, win rate analysis, and auction competitiveness assessment.
Queries pixel load and unique user metrics for data and event pixels with referrer breakout and daily granularity.
Discovers available reporting datasets with metadata including codes, names, descriptions, and endpoints. Use to explore what data is available before building queries.
Searches organizations with filters for governance, identity, and contract settings.
Retrieves an organization's contract controls, identity policies, exchange seats, and billing configuration.
Searches agencies with filters for organization, data sharing, MFA posture, and status.
Retrieves a single agency's configuration including data sharing settings, MFA inheritance, and organization linkage.
Searches advertisers with filters for agency, organization, domain, identity, and compliance flags.
Retrieves an advertiser's full configuration including cross-strategy settings, MFA inheritance, and vendor attribution pixels.
Searches audience segments across vendors, taxonomy paths, and buyable status.
Important: Search queries must be at least three characters to avoid API errors.
Searches supply sources with filters for RTB settings, inventory capabilities (display, video, mobile, CTV), fraud filtering, and PMP enablement.
Retrieves full supply source configuration including RTB settings, inventory flags, attribution groups, and seat identifiers.
Searches site lists by name, organization, status, and restriction type (INCLUDE or EXCLUDE).
Retrieves a site list's restriction mode, organization ownership, and content counts.
Searches PMP deals with filters for name, deal identifier, supply source, status, deal type (standard or PG), and more. Supports partial/wildcard matching on name and description fields.
Retrieves a single deal's full configuration including pricing, publisher details, and identifiers. Supports currency conversion.
Searches for MediaMath users by name, email, role, scope, or account type.
Retrieves a user's profile, roles, and basic access. Defaults to the authenticated user when no ID is supplied.
Retrieves detailed permission flags and entity-level access lists (organizations, agencies, advertisers) for a user.
Most workflows follow a three-step pattern:
- Discover entities using
find_*tools with filters - Inspect specific entities using
get_*_infotools - Act on entities using
create,update, or specialized tools
For example:
find_campaigns(advertiser_id: 242869, status: true)
→ get_campaign_info(campaign_id: 1383420, extended: true)
→ campaign_update(campaign_id: 1383420, pacing: {...})Search tools that return multiple results support cursor-based pagination. When a result set exceeds the page limit (typically 25), the response includes a cursor value that can be passed to the next call to retrieve additional results.
Each tool includes contextual guidance about related tools — what to call before and after — enabling AI agents to chain operations into coherent workflows without requiring explicit scripting.
- See Best Practices for recommended workflows and prompt patterns.
- Return to Overview for general product information.