{
  "markdown": "# turbometrics MCP Server\n\nConnect Claude and other AI tools directly to your [turbometrics.io](https://turbometrics.io) account.\n\n## What you can do\n\nAsk your AI assistant questions like:\n\n**Scans & Performance**\n- \"What's the performance score of turbopress.de?\"\n- \"Which findings does turbometrics.io have?\"\n- \"Has my score improved this week?\"\n- \"Compare turbopress.de with turbometrics.io\"\n- \"Scan https://new-client-site.com and show me the results\" *(any URL, even unmonitored ones)*\n- \"Start a scan for example.com in the EU region\"\n\n**Real User Monitoring**\n- \"Show Core Web Vitals for turbopress.de\"\n- \"How has the LCP of my site trended over the last 30 days?\"\n- \"Which pages on turbopress.de have the worst LCP?\"\n- \"Compare INP this week vs last week\"\n\n**Alerts & Account**\n- \"Show all open alerts\"\n- \"List my recent scans filtered by status\"\n- \"Show details for alert #123\"\n- \"Mark all alerts as read\"\n- \"What plan am I on and how many API requests do I have left today?\"\n\n## Requirements\n\n- A turbometrics.io account (Starter plan or higher)\n\nThat's it. Sign-in happens in your browser — there is no token to copy.\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_domains` | List all monitored URLs with schedule and status |\n| `get_latest_scan` | Latest scan result: score, findings, TTFB, Core Web Vitals, report link |\n| `get_scan_history` | Score history — works for monitored and new domains |\n| `get_findings` | Detailed findings for a specific scan |\n| `list_alerts` | List open or resolved alerts |\n| `get_rum_summary` | Real User Monitoring summary: Core Web Vitals p75 values |\n| `get_rum_metric_history` | Daily trend for a RUM metric (LCP, CLS, INP, FCP, TTFB) |\n| `get_rum_pages` | Slowest pages ranked by metric |\n| `compare_domains` | Compare two domains side by side, with a report link for each |\n| `trigger_scan` | Start a scan for any URL — new or monitored; supports region, force, and auth |\n| `list_scans` | List scans — filterable by domain, status and page, with report links |\n| `get_alert` | Get details for a specific alert |\n| `mark_alerts_read` | Mark alerts as read |\n| `get_account_info` | Account details: plan, API limits, RUM status |\n\n## Authentication\n\nOAuth 2.1 with PKCE. Your client sends you to turbometrics.io, you approve once,\nand the client holds the token from then on. Access tokens last an hour and are\nrenewed in the background; you can revoke any connected app at any time under\n[Profile → API & apps](https://turbometrics.io/profile/api).\n\nClients that do not speak OAuth can still authenticate with a personal API\ntoken from the same page, sent as `Authorization: Bearer YOUR_API_TOKEN`.\n\n## Setup\n\n### Claude (recommended)\n\nClaude supports custom connectors straight from the UI — no Node.js, no `npx`,\nno config file to edit.\n\n1. In Claude: **Settings → Connectors → \"Add custom connector\"**\n2. Enter:\n   - **Name:** `turbometrics`\n   - **URL:** `https://turbometrics.io/mcp`\n3. Click **\"Add\"**, then **\"Connect\"**\n4. Approve the access in the browser window that opens\n\nUse `.io`, not `.de` — the sign-in lives only on `turbometrics.io`, and a\nconnector pointed at the other domain cannot authorise itself.\n\nThe connector applies to your whole Claude account — claude.ai, desktop app and\nmobile apps alike.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http turbometrics https://turbometrics.io/mcp\n```\n\nThe browser opens for sign-in on first use.\n\n### ChatGPT\n\nDeveloper mode is in beta and requires ChatGPT Plus or Pro.\n\n1. Enable **Settings → Developer Mode**\n2. **Apps & Connectors → create a new connector**\n3. Server URL: `https://turbometrics.io/mcp`\n4. Choose OAuth as the authentication method and approve in the browser\n\n### Other MCP clients (Cursor, Windsurf, etc.)\n\n| Setting | Value |\n|---------|-------|\n| Server URL | `https://turbometrics.io/mcp` |\n| Transport | Streamable HTTP |\n| Auth | OAuth 2.1 (discovery is automatic), or `Authorization: Bearer YOUR_API_TOKEN` |\n\n### Fallback: local setup via `mcp-remote`\n\nOnly needed for clients without a connector UI, or for older Claude/ChatGPT\ndesktop versions. `mcp-remote` performs the OAuth flow itself — no token in the\nconfig file. Requires Node.js (`brew install node`, or the installer from\n[nodejs.org](https://nodejs.org/en/download)).\n\n`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac,\n`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows:\n\n```json\n{\n  \"mcpServers\": {\n    \"turbometrics\": {\n      \"command\": \"/opt/homebrew/bin/npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://turbometrics.io/mcp\"\n      ]\n    }\n  }\n}\n```\n\nAdjust the `npx` path to your system (`which npx` on Mac, `where npx` in CMD on\nWindows), then restart the client.\n\nStep-by-step instructions for every client: [turbometrics.io/docs/mcp](https://turbometrics.io/docs/mcp)\n\n## Plans\n\nAPI access is available from the **Starter plan** and above.\n\n| Plan | Daily API Limit |\n|------|----------------|\n| Starter | 1,000 requests |\n| Pro | 5,000 requests |\n| Agency | Unlimited |\n",
  "bytes": 5061,
  "sha": "ca4e5f55d9d562c9f5bd4080c02a880d40fd2359a91614bd70b5240f849b2bf6",
  "repo_slug": "turbopress-de/turbometrics-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_turbopress_de_turbometrics_mcp_bc15c3f8/readme"
}