io.github.turbopress-de/turbometrics-mcp

turbometrics MCP Server

Connect Claude and other AI tools directly to your turbometrics.io account.

What you can do

Ask your AI assistant questions like:

Scans & Performance

• "What's the performance score of turbopress.de?"
• "Which findings does turbometrics.io have?"
• "Has my score improved this week?"
• "Compare turbopress.de with turbometrics.io"
• "Scan https://new-client-site.com and show me the results" (any URL, even unmonitored ones)
• "Start a scan for example.com from Helsinki"

Real User Monitoring

• "Show Core Web Vitals for turbopress.de"
• "How has the LCP of my site trended over the last 30 days?"
• "Which pages on turbopress.de have the worst LCP?"
• "Compare INP this week vs last week"

Alerts & Account

• "Show all open alerts"
• "List my recent scans filtered by status"
• "Show details for alert #123"
• "Mark the open score alerts as read"
• "What plan am I on and how many API requests do I have left today?"

Requirements

• A turbometrics.io account (Starter plan or higher)

That's it. Sign-in happens in your browser — there is no token to copy.

Available Tools

Every tool carries MCP annotations (title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Twelve tools only read your account. mark_alerts_read changes the read state of the alerts you name, and trigger_scan is the only tool that reaches out to third-party websites.

Authentication

OAuth 2.1 with PKCE. Your client sends you to turbometrics.io, you approve once, and the client holds the token from then on. Access tokens last an hour and are renewed in the background; you can revoke any connected app at any time under Profile → API & apps.

Clients that do not speak OAuth can still authenticate with a personal API token from the same page, sent as Authorization: Bearer YOUR_API_TOKEN.

Setup

Claude (recommended)

Claude supports custom connectors straight from the UI — no Node.js, no npx, no config file to edit.

1. In Claude: Settings → Connectors → "Add custom connector"
2. Enter:
   • Name: turbometrics
   • URL: https://turbometrics.io/mcp
3. Click "Add", then "Connect"
4. Approve the access in the browser window that opens

Use .io, not .de — the sign-in lives only on turbometrics.io, and a connector pointed at the other domain cannot authorise itself.

The connector applies to your whole Claude account — claude.ai, desktop app and mobile apps alike.

Claude Code

claude mcp add --transport http turbometrics https://turbometrics.io/mcp

The browser opens for sign-in on first use.

ChatGPT

Developer mode is in beta and requires ChatGPT Plus or Pro.

1. Enable Settings → Developer Mode
2. Apps & Connectors → create a new connector
3. Server URL: https://turbometrics.io/mcp
4. Choose OAuth as the authentication method and approve in the browser

Other MCP clients (Cursor, Windsurf, etc.)

Fallback: local setup via mcp-remote

Only needed for clients without a connector UI, or for older Claude/ChatGPT desktop versions. mcp-remote performs the OAuth flow itself — no token in the config file. Requires Node.js (brew install node, or the installer from nodejs.org).

~/Library/Application Support/Claude/claude_desktop_config.json on Mac, %APPDATA%\Claude\claude_desktop_config.json on Windows:

{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.io/mcp"
      ]
    }
  }
}

Adjust the npx path to your system (which npx on Mac, where npx in CMD on Windows), then restart the client.

Step-by-step instructions for every client: turbometrics.io/docs/mcp

Plans

API access is available from the Starter plan and above.