Skip to main content
SegmentStream MCP provides 44 tools organized into functional categories. Your AI assistant automatically discovers and uses these tools based on your prompts — you do not need to call them explicitly. Tools work best when combined. For example, to get a campaign performance report, the assistant will first call list_active_projects to find your project, then list_conversions and list_attribution_models to resolve the right IDs, and finally get_report_table to fetch the data.
All tools are read-only. SegmentStream MCP cannot modify your project configuration.

​
Projects and account

Tools for listing projects and checking your account.
List all active SegmentStream projects you have access to, including their ID, name, timezone, type, and account.Example prompts:
  • “List all my SegmentStream projects”
  • “Which projects do I have access to?”
  • “Show me the project IDs for all active projects”
Get full details for a specific project: name, timezone, currency, type, features, workflow state, and billing account.Parameters: projectIdExample prompts:
  • “Show me the details of project X”
  • “What timezone and currency is this project configured with?”
  • “What features are enabled for this project?”
Get the authenticated user’s profile: ID, name, email, and role.Example prompts:
  • “Who am I logged in as?”
  • “What permissions do I have?”

​
Data sources

Tools for inspecting connected advertising platforms and their import status.
List all data sources configured for a project.Parameters: projectIdExample prompts:
  • “What ad platforms are connected to this project?”
  • “Show me all data sources”
  • “Which data sources are enabled?”
Get details for a specific data source: name, type, enabled status, authentication status, configuration options, and workflow status.Parameters: dataSourceIdExample prompts:
  • “Show me the configuration of the Facebook data source”
  • “Is the Google Ads data source authenticated?”
Get import logs for a data source, including phase, start time, fill date, status, errors, and messages.Parameters: projectId, dataSourceIdExample prompts:
  • “Show me the recent import logs for our Facebook data source”
  • “Are there any import errors for Google Ads?”
  • “When was the last successful import for this data source?”

​
Data streams

Tools for inspecting event data streams (GA4 BigQuery exports, SDK streams, etc.).
List all data streams for a project with their ID, type, timezone, enabled status, connection status, display name, destination table, and configuration.Parameters: projectIdExample prompts:
  • “What data streams are configured?”
  • “Show me all connected event tracking sources”
  • “Is the GA4 BigQuery stream connected?”
Get details for a specific data stream.Parameters: dataStreamIdExample prompts:
  • “Show me the configuration of this data stream”
  • “What table does this stream write to?”
Test whether a data stream can connect to its data source. Returns a status code where non-zero indicates success.Parameters: dataStreamIdExample prompts:
  • “Test the connection for our GA4 data stream”
  • “Is the data stream still connected?”

​
Conversions

Tools for inspecting conversion definitions, statistics, and geographic breakdowns.
List all conversions for a project with their ID, name, type, modelled conversion ID, uniqueness settings, and visibility flags.Parameters: projectIdExample prompts:
  • “What conversions are configured in this project?”
  • “List all active conversions”
  • “Show me the conversion IDs I need for reporting”
Get the full configuration of a conversion, including events, audiences, deduplication settings, attribution settings, data sources, and combined conversions.Parameters: conversionIdExample prompts:
  • “Show me how the Purchase conversion is configured”
  • “What events trigger this conversion?”
  • “What deduplication settings does this conversion use?”
Get conversion statistics: total conversions, sessions, values, visitors, conversion history by date, and export history.Parameters: projectId, conversionId (optional: dateFrom, dateTo, chartGranularity)Example prompts:
  • “How many purchases happened last month?”
  • “Show me the daily conversion trend for the past 30 days”
  • “What is the total conversion value this quarter?”
Get conversions grouped by country for a specific conversion and date range.Parameters: projectId, conversionId, startDate, endDateExample prompts:
  • “Which countries had the most purchases last month?”
  • “Break down lead conversions by country for Q4”

​
Attribution models

Tools for inspecting attribution model configurations.
List all attribution models for a project with their ID, name, algorithm, attribution window, adjustment, filter, dimension, default status, and disabled status.Parameters: projectIdExample prompts:
  • “What attribution models are available?”
  • “Which attribution model is the default?”
  • “Show me all attribution model IDs”
Get full details of an attribution model, including calibration settings, dimension values, and self-reported attribution configuration.Parameters: projectId, idExample prompts:
  • “Show me the configuration of the Multi-Touch attribution model”
  • “What is the attribution window for the Last Click model?”
  • “Does this model use self-reported attribution?”

​
Reports and analytics

Tools for querying campaign performance data — the primary way to pull metrics from SegmentStream.
The main reporting tool. Query campaign performance data with dimensions, attribution metrics, conversion metrics, filters, sorting, and pagination.Supports 30 built-in dimensions (campaign name, ad platform, country, source/medium, etc.) and custom dimensions. Returns data as CSV (compact) or JSON.Parameters: projectId, params (includes firstDateRange, dimensions, attributionMetrics, conversionsMetrics, attributedConversions, filter, orderBy*, limit, offset)Example prompts:
  • “Show me the top 10 campaigns by cost for the last 30 days”
  • “What is the ROAS by ad platform for last month?”
  • “Give me a breakdown of conversions by source/medium and country”
  • “Compare campaign performance between this month and last month”
Get time-series chart data: per-date attribution metrics, conversion metrics, and calculated metrics. Supports day, hour, week, and month granularity.Parameters: projectId, params (includes dateRange, granularity, attributionMetrics, conversionsMetrics, attributedConversions, filter)Example prompts:
  • “Show me the daily cost trend for the past 30 days”
  • “Plot weekly conversions over the last 3 months”
  • “Chart the ROAS trend by week for Facebook campaigns”
List all saved report configurations for a project. Returns the ID, name, and display order for each report.Parameters: projectIdExample prompts:
  • “What reports are saved in this project?”
  • “List all report configurations”
Get the full settings of a saved report: date ranges, dimensions, metrics, filters, ordering, and chart configuration.Parameters: projectId, reportIdExample prompts:
  • “Show me the configuration of the Performance Overview report”
  • “What dimensions and metrics does this report use?”
Get available values for a report dimension — used to discover filter options. Supports both built-in dimensions (campaign name, ad platform, etc.) and custom fields.Parameters: projectId (optional: commonDimensionV4, customField, customFieldScope, prefix)Example prompts:
  • “What campaign names are available for filtering?”
  • “List all ad platform values in this project”
  • “What values are available for the source_medium dimension?”
Start a CSV export for a report. Returns a job ID that you can poll with get_download_job to get the download URL once the export is ready.Parameters: projectId, params (same as get_report_table)Example prompts:
  • “Export this report as a CSV”
  • “Download campaign performance data for the last quarter”
Check the status of a CSV or Google Sheets export job. Returns progress (0–100), status (waiting, active, completed, failed), download URL, and failure reason.Parameters: projectId, jobId, typeExample prompts:
  • “Is my CSV export ready?”
  • “Check the status of the download job”
Get the generated BigQuery SQL for a report query without executing it. Useful for debugging or understanding how report data is assembled.Parameters: projectId, params (same as get_report_table)Example prompts:
  • “Show me the SQL that would be generated for this report”
  • “What BigQuery query does SegmentStream run for campaign performance?”

​
User journey

Tools for tracing individual user paths and attribution credit distribution.
Query the full user journey for a date range. Returns sessions with attribution credits, conversions, audience memberships, and user keys. Filter by anonymous ID or user ID.Parameters: projectId, params (includes dateFrom, dateTo, selectedAnonymousId or selectedUserId, attributedConversions, conversionInternalIds, useCookieMatchingByUserId)Example prompts:
  • “Show me the user journey for anonymous ID abc123 over the last 30 days”
  • “What touchpoints led to the last conversion for user [email protected]?”
  • “Trace the journey for this anonymous ID and show attribution credits”
Get the generated BigQuery SQL for a user journey query without executing it. Useful for debugging attribution logic.Parameters: projectId, params (same as query_user_journey)Example prompts:
  • “Show me the SQL behind this user journey query”
  • “Debug the user journey query for this anonymous ID”

​
BigQuery

Direct SQL access to your project’s BigQuery dataset.
Execute a BigQuery SQL query against your project’s dataset and return results as JSON.Parameters: projectId, queryExample prompts:
  • “Run a query to count sessions by country for last week”
  • “Show me the schema of the sessions table”
  • “Query the raw events table for the last 24 hours”
  • “How many unique users visited the site yesterday?”

​
Custom dimensions

Tools for inspecting custom dimensions configured in your project.
List all custom dimensions for a project with their key, name, and type.Parameters: projectIdExample prompts:
  • “What custom dimensions are available?”
  • “List all custom dimension keys I can use in reports”
Get full details of a custom dimension, including the SQL expression and dimension groups.Parameters: projectId, keyExample prompts:
  • “Show me the SQL expression for the brand/non-brand custom dimension”
  • “How is this custom dimension calculated?”

​
Self-reported attribution

Tools for inspecting self-reported attribution (SRA) settings.
Get the self-reported attribution configuration for a project, including the extraction SQL, classifier settings, channel mappings, override conditions, and migration status.Parameters: projectIdExample prompts:
  • “Show me the self-reported attribution settings”
  • “What channel mappings are configured for SRA?”
  • “Is the SRA classifier enabled?”

​
Audiences

Tools for inspecting audience definitions and memberships.
List audiences for a project. Optionally filter by ML model or conversion. Returns ID, name, filter, membership duration, and status for each audience.Parameters: projectId (optional: mlModelId, conversionId)Example prompts:
  • “What audiences are defined in this project?”
  • “List all audiences associated with the Purchase conversion”
Get full details of an audience, including filter expression, SQL, membership duration, and timestamps.Parameters: audienceIdExample prompts:
  • “Show me the filter criteria for this audience”
  • “How long do users stay in this audience?”
Query audience memberships for a specific client (anonymous ID) within a date range. Returns audience names, entry times, and expiration times.Parameters: projectId, anonymousId, from, toExample prompts:
  • “What audiences does anonymous ID abc123 belong to?”
  • “Show me audience memberships for this user over the last 30 days”
Get audience inclusion statistics: per-audience inclusion count and percentage, total inclusion, and total user count. Optionally filter by ML model.Parameters: projectId (optional: mlModelId)Example prompts:
  • “What percentage of users are in each audience?”
  • “Show me audience inclusion statistics”

​
Workflows

Tools for monitoring data processing workflows.
List recent workflows for a project.Parameters: projectId (optional: limit)Example prompts:
  • “Show me the recent workflows”
  • “What data processing jobs ran today?”
Get the status and details of a specific workflow, including data source logs and errors.Parameters: workflowIdExample prompts:
  • “What is the status of this workflow?”
  • “Did this workflow complete successfully?”
  • “Show me any errors from the last workflow run”

​
Cost data quality

Tools for monitoring advertising cost data accuracy.
Get cost data quality scores (total, 7-day, and 1-day) and a histogram. Optionally scope to a specific data source or date range.Parameters: projectId (optional: dataSourceId, dateFrom, dateTo)Example prompts:
  • “What is the cost data quality score for this project?”
  • “Show me the data quality for the Facebook data source”
  • “How has cost data quality changed over the last 30 days?”

​
Identity graph

Tools for inspecting user identity stitching.
Get identity graph statistics including user stitching distribution, key combinations, and data completeness.Parameters: projectId (optional: conversionInternalId, daysBack, useUsersV2)Example prompts:
  • “Show me the identity graph statistics”
  • “How many users have cross-device stitching?”
  • “What is the user stitching distribution for the last 30 days?”

​
Incidents

Tools for checking project health alerts.
List incidents for a project. Optionally filter by status (Ok or Error) and paginate results.Parameters: projectId (optional: status, limit, offset, minimumUpdatedAt)Example prompts:
  • “Are there any active incidents?”
  • “Show me recent errors for this project”
  • “List all incidents from the last week”

​
Classifiers (ML models)

Tools for inspecting ML-based classifiers used for conversion scoring.
List all classifiers for a project with their configuration.Parameters: projectIdExample prompts:
  • “What ML classifiers are configured?”
  • “Show me the classifier settings for this project”
Get the full configuration of a specific classifier.Parameters: classifierIdExample prompts:
  • “Show me the details of this classifier”
  • “What model does this classifier use?”
List available classifier model types with pricing information.Example prompts:
  • “What classifier models are available?”
  • “Show me the pricing for classifier models”

​
Experiments (geo tests)

Tools for inspecting geo-lift experiments.
List all experiments for a project with their status, preparation, and analysis results.Parameters: projectIdExample prompts:
  • “What experiments are running?”
  • “Show me all geo tests and their status”
  • “List completed experiments with their results”
Get full details of a specific experiment, including plots, preparation data, and analysis results.Parameters: experimentIdExample prompts:
  • “Show me the results of this geo test”
  • “What was the measured lift in this experiment?”
  • “Show me the experiment preparation details”
Get available custom parameter keys for market-split experiments.Parameters: conversionIdExample prompts:
  • “What custom parameters can I use for geo test segmentation?”
  • “List available custom parameter keys for experiments”