MCP Tools Reference

VibesAnalytics 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.

Tool names: on the hosted MCP every tool below is registered with a vibetraker_ prefix — create_project is vibetraker_create_project, and so on. The one exception is the bootstrap tool vibes_register. Names are shown unprefixed here for readability; call them with the prefix.

Projects

create_project

Register a new site as a project in your workspace. Required: name, platform_type (web), framework (nextjs | react), and app_type (saas | consumer | subscription | ecommerce-lite | content). domain is optional. Returns the project ID.

list_projects

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

get_integration_contract

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

validate_tracking

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

Providers

connect_provider

Connect an analytics or ad platform (GA4, Meta, TikTok, LinkedIn) to a project. Auto-discovers properties and pixels 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 — sessions, signups, revenue, ROAS, conversion rates.

get_project_product_summary

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

get_project_marketing_summary

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

get_workspace_insights

Normalized metrics and insights across every project 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.