Blue Triangle MCP Server Overview

Table of Contents: 

• Overview
• Prerequisites
• Server Configuration
  • Cursor AI
  • Claude
• Important Notes
  • Timestamps & Time Ranges
  • Data Aggregation
  • Authentication
• Troubleshooting
  • Configuration Issues
  • Connection Issues
  • No Data Returned
  • Rate Limiting
     

Overview

The Blue Triangle MCP (Model Context Protocol) Server gives AI assistants direct access to your Blue Triangle performance monitoring data. Use it to query site performance metrics in plain language, automate analysis, and generate insights—no manual API integration required.

Prerequisites

• A BT MCP-compatible client (Claude, Cursor, Windsurf, Antigravity and any custom MCP client)
• A Blue Triangle account with API access
• Your API credentials: Site Tag Prefix, user API Key, and user API Email

Server Configuration

The Blue Triangle MCP Server uses HTTP transport with header-based authentication. We currently support Claude, Cursor, Windsurf, Antigravity and any custom MCP client.

Add the following to your MCP client configuration, replacing the placeholder values with your actual credentials:

{
  "mcpServers": {
    "bluetriangle": {
      "transport": "http",
      "url": "https://mcp.bluetriangle.com/mcp",
      "headers": {
        "X-API-Key": "API KEY",
        "X-API-Email": "USER EMAIL",
        "X-Site-Prefix": "TAG PREFIX",
	      "Revenue-Enabled": "true/false"
  }
}
}

Note: Revenue-Enabled is optional.

Cursor AI

Steps

1. Go to Settings > Tools & MCP.
2. Click New MCP Server. This opens an mcp.json file.
3. Add the Blue Triangle MCP server configuration. Replace <YOUR_BLUE_TRIANGLE_EMAIL> and <YOUR_BLUE_TRIANGLE_API_KEY> with your own values, then save the file.

   {
     "mcpServers": {
       "Blue Triangle": {
         "url": "https://mcp.bluetriangle.com/mcp",
         "headers": {
           "X-API-Email": "<YOUR_BLUE_TRIANGLE_EMAIL>",
           "X-API-Key": "<YOUR_BLUE_TRIANGLE_API_KEY>"
         }
       }
     }
   }

4. Save and restart Cursor.

Claude

We now support OAuth. Connect to Claude easily via the Blue Triangle MCP connector.

Steps

1. In Claude, click your name in the bottom-left corner.
2. Open Settings (gear icon).
3. Go to Connectors.
4. Search for Blue Triangle MCP.
   
5. Click Connect next to Blue Triangle MCP.
6. A login portal will open. Log in with your Blue Triangle account.
7. On the authorization screen, click Authorize.
8. You'll be redirected back to Claude. Ask Blue Triangle will now appear in your pins.

Result

Once connected, you can use the Ask Blue Triangle pin to query Blue Triangle data directly within Claude.

Important Notes

Timestamps & Time Ranges

• All timestamps must be Unix epoch in seconds (e.g., 1737067739).
• All timing metrics are returned in milliseconds.
• Maximum date range per query: 90 days.
• Rate limit: 60 calls per minute per user.

Data Aggregation

• Geometric mean is used by default for performance metrics.
• Use percentile aggregation for distribution analysis.
• Maximum of 3 grouping dimensions per query.

Authentication

Authentication is handled automatically via the MCP configuration headers (X-API-Key, X-API-Email, X-Site-ID).

• Never share credentials publicly.
• Rotate API keys regularly.
• Use separate credentials per environment.
• Secure configuration files with appropriate file permissions.

Troubleshooting

Configuration Issues

• Validate JSON syntax — no trailing commas.
• Use "transport": "http" (not "url" or "sse").
• Header names are case-sensitive.

Connection Issues

• Verify your API credentials are active.
• Confirm your Site ID is correct (must be numeric).
• Restart your MCP client after any configuration changes.
• Check firewall rules and network connectivity.

No Data Returned

• Verify the time range and Unix timestamp conversion.
• Confirm data collection was active during the queried period.
• Check metric availability for your selected dataType.
• Try a simpler query to isolate the issue.

Rate Limiting

• If the rate limit is exceeded, wait 60 seconds before retrying.
• Use time bucketing to retrieve more data in fewer queries.