Blue Triangle MCP Server: Performance Endpoint

Table of Contents

• Overview
• Prerequisites
• Server Configuration 
  • Claude Desktop (macOS / Windows)
  • Cursor AI
• Available Tools
  • get_performance_data
    • Required Parameters
    • Optional Parameters
    • Sample Request
  • compare_performance_data
    • Required Parameters
  • Available Metrics
    • Core Web Vitals & User Experience
    • Page Load Timing
    • Business & Traffic
    • Error & Status Tracking
  • Example Queries
    • Core Web Vitals
    • Performance Trends
    • Multi-Dimensional Analysis
    • Error Monitoring
  • Important Notes
    • Timestamps & Time Ranges
    • Data Aggregation
    • Authentication
  • Troubleshooting
    • Configuration Issues
    • Connection Issues
    • No Data Returned
    • Rate Limiting
  • Support & Resources

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.

Current Status: The Performance Endpoint MCP Server is now available. Additional MCP servers and expanded tool capabilities are actively in development.

Prerequisites

• An MCP-compatible client (Claude Desktop, Cursor AI, Claude Code, or similar)
• A Blue Triangle account with API access
• Your API credentials: Site ID, API Key, and API Email

Server Configuration

The Blue Triangle MCP Server uses HTTP transport with header-based authentication. 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": "your-api-key",
    "X-API-Email": "your-email@company.com",
    "X-Site-ID": "your-site-id"
  }
} } }

Claude Desktop (macOS / Windows)

1. Open Claude Desktop and click Settings from the top menu.
2. Navigate to Developer > MCP Servers.
3. Click Add Server and paste the configuration above.
4. Save and restart Claude Desktop.
5. Verify the connection by querying your performance data.

Cursor AI

1. Go to Settings > Tools & MCP.
2. Click New MCP Server.
3. Add the Blue Triangle MCP server configuration.
4. Save and restart Cursor.

Available Tools

get_performance_data

Retrieve raw and aggregated performance and business data captured by Blue Triangle. Data can be broken down by minute, hour, or day, and grouped by dimensions such as country, region, or page name.

Required Parameters

Note: The basepage dataType returns data for both base page measurements and advanced synthetic scripts.

Optional Parameters

Sample Request

{"startDate": 1737000000,
 "endDate": 1737086400,
 "group": ["pageName"],
 "columns": ["largestContentfulPaint", "pageHits", "onload"],
 "dataType": "rum"}

compare_performance_data

Compare performance data between two date ranges. This tool calls the performance API twice and returns side-by-side comparison data—ideal for queries like 'this week vs. last week' or 'current month vs. previous month.'

Required Parameters

Note: This tool accepts the same optional parameters as get_performance_data (see above).

Available Metrics

Core Web Vitals & User Experience

Note: Current Core Web Vitals (as of March 2024) are LCP, CLS, and INP. FID is available for historical analysis only.

Page Load Timing

Business & Traffic

Error & Status Tracking

Example Queries

Core Web Vitals

• "Show me Core Web Vitals (LCP, INP, CLS) for the last 7 days"
• "What's our LCP performance by device type this month?"
• "Show me 95th percentile LCP by country"

Performance Trends

• "Compare this week's performance to last week"
• "Show me daily onload time trends for the last 30 days"
• "How has First Byte time changed over the past month?"

Multi-Dimensional Analysis

• "Break down page load times by browser, device, and country"
• "Show me performance metrics by A/B test segment"
• "Compare performance across page groups by visitor type"

Error Monitoring

• "Show me JavaScript error counts by page for the last 24 hours"
• "What's our HTTP error rate by status code this week?"

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.

Support & Resources

• Support: Contact your Blue Triangle account team or visit the support portal.
• Documentation: https://help.bluetriangle.com 
• Blue Triangle Platform: https://www.bluetriangle.com 
• MCP Specification: https://modelcontextprotocol.io