Tideways MCP Server: Install & Setup

Install Tideways in Claude Code

npm

Claude Code

claude mcp add tideways -e TIDEWAYS_TOKEN=... -- npx -y tideways-mcp-server

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "tideways": {
      "command": "npx",
      "args": [
        "-y",
        "tideways-mcp-server"
      ],
      "env": {
        "TIDEWAYS_TOKEN": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add tideways -e TIDEWAYS_TOKEN=... -- docker run -i --rm -e TIDEWAYS_TOKEN ghcr.io/abuhamza/tideways-mcp-server:2.1.1

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "tideways": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TIDEWAYS_TOKEN",
        "ghcr.io/abuhamza/tideways-mcp-server:2.1.1"
      ],
      "env": {
        "TIDEWAYS_TOKEN": "..."
      }
    }
  }
}

MCP Bundle (.mcpb)

Claude Code

curl -LO https://github.com/abuhamza/tideways-mcp-server/releases/download/v2.1.1/tideways-mcp-server-2.1.1.mcpb

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

Download tideways-mcp-server-2.1.1.mcpb and double-click it to install in Claude Desktop.

MCP Bundles install in one click in Claude Desktop. Download the file, then open it.

Replace each ... with your own value.

Frequently asked questions

What does the Tideways MCP server do?

Read-only access to Tideways PHP performance monitoring: performance, issues, traces, history.

Is the Tideways MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Tideways run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Tideways to Claude Code?

Run: claude mcp add tideways -e TIDEWAYS_TOKEN=... -- npx -y tideways-mcp-server

More monitoring & observability MCP servers

View all

Scout Monitoring (local)

scoutapp/scout-mcp-local

Run Scout Monitoring's MCP tools locally with an API key: endpoints, traces, errors, N+1 insights.

LocalAccount needed

App Metrica

3847

pavellunev/app_metrica_mcp

AppMetrica (Yandex) analytics: reports, funnels, segments, dashboards, logs export, push

LocalFree

Grafana Loki

tumf/grafana-loki-mcp

Query Loki logs through the Grafana API.

LocalFreePython

Duplicacy

2877

GeiserX/duplicacy-mcp

Duplicacy backup monitoring: query backup job status and Prometheus metrics from a Duplicacy exporter.

LocalAccount neededGo

Grafana

0866

itzhouq/grafana-mcp

Read-only project-level Grafana MCP: Loki logs, metrics, traces, alerts, test/prod switching

LocalFree

Raygun

MindscapeHQ/mcp-server-raygun

Interact with your crash reporting and real using monitoring data on your Raygun account

RemoteAccount neededTypeScript