Turbometrics MCP Server

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 in the EU region"

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 all 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)
• An API token from Profile → API

Available Tools

Authentication

Every request requires a Bearer token passed via the Authorization header. Get your token at turbometrics.io/profile/api.

Setup

Claude (recommended)

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

1. Get your API token from Profile → API
2. In Claude: Settings → Connectors → "Add custom connector"
3. Enter:
   • Name: turbometrics
   • URL: https://turbometrics.io/mcp
4. Under "Request headers", add:
   • Name: Authorization
   • Value: Bearer YOUR_API_TOKEN
5. Click "Add"

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

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. Auth header: Authorization: Bearer YOUR_API_TOKEN

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. 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",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN"
      ]
    }
  }
}

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.