# Tool Reference > **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. ## Overview 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. ## Platform Health ### healthcheck 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. ## Campaign Management ### find_campaigns 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) ### get_campaign_info 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. ### campaign_create 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. ### campaign_update Applies partial updates to an existing campaign's settings. Only specified fields are modified; omitted fields remain unchanged. ## Strategy Management ### find_strategies 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 ### get_strategy_info Retrieves comprehensive strategy configuration including pacing, goals, inventory, and targeting details. Use `extended=true` for audience/contextual group details and full targeting breakdowns. ### strategy_create 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_type` cannot be `roi` or `cpa` unless `use_optimization` is true and a merit pixel is set on the parent campaign. - `spend` goal type is only supported when `use_optimization` is false. ### strategy_update Applies partial updates to an existing strategy. Supports modification of all strategy fields including goals, pacing, targeting, inventory, and creative assignments. ## Creative Management ### find_atomic_creatives 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 ### get_atomic_creative_info Retrieves a single atomic creative's full configuration including dimensions, tags, approval status, click-through URL, and metadata. ### get_atomic_creative_preview 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. ### atomic_creative_healthcheck 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. ### find_native_creatives Searches native (component) creatives with filters for advertiser, organization, status, and text search. Native creatives contain component assets like title, body, images, and videos. ### get_native_creative_info Retrieves detailed information for a single native creative including all component assets, clickthrough URLs, concept information, and optional preview data. ### get_native_creative_approvals Checks approval status for native/component creatives across advertising sources. Use this instead of `atomic_creative_healthcheck` for native creatives. ### get_video_creative_info Retrieves detailed information for a single video creative including duration, encoding status, VAST version, security status, companion ads, event pixels, and vendor information. ### list_video_creatives Bulk fetches video creative details for an array of creative IDs (1–100 per call). ### video_creative_create 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. ### video_creative_update Applies partial updates to an existing video creative. Supports both T1AS and 3PAS creatives. ## Concepts (Creative Groups) ### find_concepts 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. ### get_concept_info Retrieves concept metadata including advertiser ownership and attached creative/strategy associations. ## Reporting & Analytics ### query_report 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` ### query_hourly_performance_report 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. ### query_all_dimensions_report 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. ### query_win_loss_report 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. ### query_pixel_loads_report Queries pixel load and unique user metrics for data and event pixels with referrer breakout and daily granularity. ### list_datasets Discovers available reporting datasets with metadata including codes, names, descriptions, and endpoints. Use to explore what data is available before building queries. ## Organization & Entity Management ### find_organizations Searches organizations with filters for governance, identity, and contract settings. ### get_organization_info Retrieves an organization's contract controls, identity policies, exchange seats, and billing configuration. ### find_agencies Searches agencies with filters for organization, data sharing, MFA posture, and status. ### get_agency_info Retrieves a single agency's configuration including data sharing settings, MFA inheritance, and organization linkage. ### find_advertisers Searches advertisers with filters for agency, organization, domain, identity, and compliance flags. ### get_advertiser_info Retrieves an advertiser's full configuration including cross-strategy settings, MFA inheritance, and vendor attribution pixels. ## Audience & Data ### find_audience_segments Searches audience segments across vendors, taxonomy paths, and buyable status. > **Important:** Search queries must be at least three characters to avoid API errors. ## Inventory & Supply ### find_supply_sources Searches supply sources with filters for RTB settings, inventory capabilities (display, video, mobile, CTV), fraud filtering, and PMP enablement. ### get_supply_source_info Retrieves full supply source configuration including RTB settings, inventory flags, attribution groups, and seat identifiers. ### find_site_lists Searches site lists by name, organization, status, and restriction type (INCLUDE or EXCLUDE). ### get_site_list_info Retrieves a site list's restriction mode, organization ownership, and content counts. ### find_deals 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. ### get_deal_info Retrieves a single deal's full configuration including pricing, publisher details, and identifiers. Supports currency conversion. ## User & Permissions ### find_user Searches for MediaMath users by name, email, role, scope, or account type. ### get_user_info Retrieves a user's profile, roles, and basic access. Defaults to the authenticated user when no ID is supplied. ### get_user_permissions Retrieves detailed permission flags and entity-level access lists (organizations, agencies, advertisers) for a user. ## Tool Interaction Patterns ### Discovery → Inspection → Action Most workflows follow a three-step pattern: 1. **Discover** entities using `find_*` tools with filters 2. **Inspect** specific entities using `get_*_info` tools 3. **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: {...}) ``` ### Pagination 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. ### Related Tool Guidance 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. ## Next Steps - See [Best Practices](/guides/mcp/best-practices) for recommended workflows and prompt patterns. - Return to [Overview](/guides/mcp/overview) for general product information.