Tideways MCP Server

MCP server for Tideways performance monitoring integration with AI assistants

Local serverstdioTypeScript

What is the Tideways MCP Server?

MCP server for Tideways performance monitoring integration with AI assistants

The short version

A Model Context Protocol (MCP) server that enables AI assistants to query Tideways performance monitoring data and provide conversational performance insights for PHP applications.

  • Conversational Performance Insights — Get performance data in natural language format optimized for AI assistants
  • AI Assistant Integration — Works with Claude Desktop, Cursor, Claude Code, and other MCP-compatible tools
  • Real-time Performance Metrics — Query current performance data with configurable rate limiting
  • Trace Analysis — List and filter traces with layer breakdown, bottleneck detection, and response time analysis
  • Issue Analysis — Retrieve and analyze errors, exceptions, and performance issues
  • Robust Error Handling — Comprehensive error handling with user-friendly messages

What it needs from you

  • Tideways account with a valid API token - API token with appropriate scopes (metrics, issues, traces) - see API documentation - Access to a Tideways organization and project

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_performance_metricsRetrieve aggregate performance metrics and system-wide statistics.
get_performance_summaryRetrieve time-series performance summary data in 15-minute intervals for trend analysis.
get_issuesRetrieve and analyze recent errors, exceptions, and performance issues.
get_tracesAnalyze individual trace samples for detailed bottleneck identification and performance debugging.
get_historical_dataRetrieve historical performance data for specific dates with configurable granularity.

How to install the Tideways MCP Server

{
  "mcpServers": {
    "tideways": {
      "command": "npx",
      "args": [
        "tideways-mcp"
      ],
      "env": {
        "TIDEWAYS_TOKEN": "YOUR_TIDEWAYS_TOKEN",
        "TIDEWAYS_ORG": "your_org",
        "TIDEWAYS_PROJECT": "your_project"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Tideways account with a valid API token - API token with appropriate scopes (metrics, issues, traces) - see API documentation - Access to a Tideways organization and project
VariableDescriptionRequired
TIDEWAYS_TOKENDeclared in the maintainer’s client configuration.Yes
TIDEWAYS_ORGDeclared in the maintainer’s client configuration.Check documentation
TIDEWAYS_PROJECTDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Tideways to get performance metrics.”
  • “Use Tideways to get performance summary.”
  • “Use Tideways to get issues.”

Frequently asked questions

MCP server for Tideways performance monitoring integration with AI assistants Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.