Skip to main content
This page documents filter behavior across the customer MCP. Live tool discovery (tools/list) remains authoritative for the current tool inventory and input schemas. A call that passes an argument absent from the tool’s input schema is rejected with JSON-RPC error -32602.

Global evidence filters

The following parameters are available on every tool listed in the Global evidence tools section below. Values inside one array are ORed. Different dimensions are ANDed. For example, two providers plus one topic and one tag means “either provider, inside this topic, and carrying this tag.” Custom dates must be provided as a complete pair. Both endpoints are inclusive UTC calendar days. Invalid dates, UUIDs, provider values, funnel stages, incomplete ranges, and unsupported periods return INVALID_PARAMETER. Most evidence tools default to 30 days. get_competitors intentionally preserves its established all-time result when no window is supplied. Pass period: 30 when you want the same explicit 30-day scope used by most dashboard views. When a tool returns appliedFilters, that object echoes the resolved period, dates, providers, topics, tags, and funnel stages used for the result.

Global evidence tools

The following tools support the complete global evidence contract above:
  • get_brand_performance
  • get_competitors
  • get_competitor_evolution
  • get_prompts
  • get_prompt_answers
  • get_answers
  • get_source_domains
  • get_source_urls
  • get_source_trends
  • get_topics
  • get_visibility_trend
  • get_sentiment_trend
  • get_provider_breakdown
  • get_keyword_triggers
  • get_content_opportunities
  • get_competitor_comparison
  • get_prompt_signals
  • get_overview
  • get_shopping_insights
  • get_social_insights
  • get_local_insights
  • get_query_fan_out
  • get_page_presence
  • get_source_profile
  • get_competitor_position
  • get_matrix
  • get_sponsored_content
  • get_backlink_opportunities
get_follow_ups uses the same evidence scope with period (days or "all"), startDate/endDate, providers, topicIds, tagIds, and funnelStages. It does not accept the legacy single-value aliases (provider, topic, topicId, tag, tagId). Tool-specific selectors such as relationship, competitorId, domain, type, isSelf, status, promptId, granularity, groupBy, limit, and offset can be combined with the global filters when advertised by that tool.

Persona and country filters

get_prompts, get_answers, get_follow_ups, and get_matrix also accept: get_source_domains, get_source_urls and get_query_fan_out also accept countries. These three tools do not accept personaIds. Both filters use the persona and country recorded when each answer was generated, so later changes to a prompt’s configuration do not rewrite history. On get_prompts, they select prompts that have at least one matching historical answer; the returned personas remain the prompt’s current assignments.

Action Center filters

get_actions uses the dashboard Action Center vocabulary:

Measure date filters

The following tools support period, inclusive startDate/endDate, and legacy days:
  • get_ai_revenue
  • get_search_console_metrics
  • get_bing_metrics
  • get_referrer_analytics
Use either days or period, not both. Numeric period accepts 1-3650; legacy days accepts 1-365. For the four connected-provider tools above, "all" maps to a 16-month lookback. Rolling and "all" windows end on the previous UTC day; custom dates use the exact inclusive range supplied. get_page_performance uses the same date vocabulary but page-level crawler evidence retains at most 30 analytic days. Numeric periods and custom ranges longer than 30 days return INVALID_PARAMETER; period: "all" means all retained page history.

Tool-specific filters and selectors

The following tools do not consume the global answer-evidence filters: Snapshot and detail tools intentionally do not accept evidence filters: they return one selected record or the latest/current state rather than an aggregate over answer evidence.

Examples