MCP Tools Reference

VibesFlyer exposes its functionality as MCP tools so your AI coding agent can drive everything programmatically — structured JSON in, structured JSON out. This is the full tool reference. Date params (start_date, end_date) are optional everywhere and default to the last 7 days.

Projects

create_project

Register a new app as a project in your workspace. Takes the app name, framework (e.g. expo), and business type (e.g. subscription). Returns the project ID.

list_projects

List every project in your workspace with its providers and status.

get_integration_contract

Return the complete mobile tracking blueprint for a project — events, provider mappings, SDK setup, env vars, and validation checklist. See Integration Contracts.

validate_tracking

Check that canonical lifecycle events are firing and every provider is connected. Returns a pass/fail checklist with the specific gaps to fix.

Providers

connect_provider

Connect a provider (Firebase, AppsFlyer, Meta, TikTok) to a project. Auto-discovers your apps and accounts so there's no manual ID hunting.

refresh_project_metrics

Force a fresh pull of metrics from all connected providers for a project, outside the nightly pipeline.

get_meta_campaigns

Return Meta Ads campaign and ad-set data for a project, including spend and conversions.

Metrics

get_project_metrics

Normalized metrics for one project — installs, sessions, retention, revenue, ROAS.

get_project_product_summary

Product-side rollup for a project: sessions, signups, trials, activation, and retention.

get_project_marketing_summary

Marketing-side rollup for a project: spend, installs, ROAS, and channel performance.

get_workspace_insights

Normalized metrics and insights across every app in the workspace, in one call.

Insights

get_project_insights

Detected insights for a single project — funnel drops, campaign shifts, tracking gaps.

generate_project_insights

Force a fresh insight evaluation for a project, useful right after a fix.

get_daily_summary

The rolled-up daily summary your agent reads for context-rich alerts.

update_insight_threshold

Widen or tighten the normal range for a metric to control detection sensitivity.

Getting started

New here? Start with Getting Started, then have your agent call create_project and get_integration_contract.