{
  "markdown": "# Trackian MCP Plugin for Claude Code\n\nThis plugin connects Claude Code to your Trackian Marketing Analytics data via the Model Context Protocol (MCP).\n\n## Requirements\n\nTo use this plugin, you must have an active Trackian account. If you don't have one yet, [register at ai.trackian.com](https://ai.trackian.com) to get started.\n\n## Installation\n\n1. Clone or download this plugin.\n2. Get your `tmcp_` API key from the Trackian Settings page.\n3. Add your token to the `.claude-plugin/plugin.json` file under the `env` section, replacing `YOUR_TMCP_TOKEN_HERE`.\n   *(Alternatively, you can copy `.env.example` to `.env` and set `TRACKIAN_MCP_TOKEN` there, or set it in your environment variables before running Claude Code).*\n\n## Usage\n\nRun Claude Code with the plugin directory:\n\n```bash\nclaude --plugin-dir /path/to/trackian-claude-plugin\n```\n\n## Skills Included\n\nThis plugin includes three custom skills that leverage the Trackian MCP tools:\n\n*   `/trackian:report <project> <dateFrom> <dateTo>`: Generates a comprehensive channel performance report (GA4, Facebook, Google Ads, GSC).\n*   `/trackian:anomaly <project> <metric> <date>`: Investigates a specific anomaly using a structured Sentinel investigation protocol.\n*   `/trackian:analyze <project> <question>`: Performs deep data analysis using natural language.\n\n## Agents Included\n\nThis plugin also includes specialized Claude subagents that are automatically utilized by the skills above to ensure rigorous and accurate data analysis:\n\n*   `sentinel-investigator`: A specialized agent for investigating marketing anomalies using a structured protocol and Trackian MCP tools.\n*   `critical-agent`: A critical auditor that reviews analysis summaries and findings for logical inconsistencies, severity inflation, or missed critical alerts.\n*   `summarization-agent`: An expert report writer that analyzes findings from multiple agents and creates comprehensive executive summaries.\n\n## Tools Included\n\nThe plugin exposes the following MCP tools directly to Claude:\n\n*   `runGa4Report`: Pull GA4 metrics for a project and date range — traffic, sessions, conversions, revenue, and funnel events.\n*   `getFacebookMetrics`: Pull Facebook Ads time-series metrics — spend, impressions, CPM, frequency, reach, and CTR.\n*   `facebookCampaignStatus`: Check Facebook Ads campaign status (ACTIVE/PAUSED) along with daily budget, lifetime budget, and budget remaining.\n*   `getMetricFromGSC`: Pull Google Search Console time-series metrics — clicks, impressions, average position, and CTR.\n*   `inspectGscUrl`: Check the Google index status of a URL on the project's verified Search Console property.\n*   `getMetricsFromGads`: Pull Google Ads time-series metrics — cost, CPC, impressions, clicks, and conversions.\n*   `googleAdsQuery`: Run a custom GAQL query against Google Ads for anything the other tools don't cover — bid strategy, impression share, keyword quality, and more.\n*   `googleAdsCampaignStatus`: Check Google Ads campaign status (ENABLED/PAUSED) and daily budgets.\n*   `whatChanged`: Cross-platform \"what changed?\" dimensional analysis — identifies which campaigns, products, keywords, landing pages, ads, or cities drove a metric move.\n*   `listMacroFactors`: List cross-cutting macro events (algorithm updates, platform changes) overlapping a date range, to rule them in or out as causes.\n*   `getSentinelMetrics`: Get Trackian Sentinel's live-recomputed metrics and active alerts for a project on a specific date.\n*   `listSentinelAlerts`: List all Sentinel alerts firing on a project across a date window.\n*   `getSentinelIncidentDetails`: Drill into a specific Sentinel incident — hypotheses, evidence, and affected metrics.\n*   `getGuardianHealthSummary`: Rolled-up site health for a project — uptime, page speed, and GSC URL inspection.\n*   `listGuardianLogs`: Raw Guardian log entries for a project — site uptime, page speed, GSC inspections, and more.\n*   `runDataQuery`: Ask a natural-language question of the project's data warehouse, or run a custom SQL query directly.\n*   `whoAmI`: Show which Trackian account and company the current API key belongs to.\n*   `listProjects`: List every project accessible with the current API key.\n",
  "bytes": 4204,
  "sha": "ad36d45944473d54937c98087a301e9ea3d1839cd26f90704e5fb8a25272e72d",
  "repo_slug": "trackian/claude-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_trackian_claude_plugin_trackian_mcp_serv_805b17bf/readme"
}