MCP Server

The CodSpeed MCP server gives AI-powered tools direct access to your performance data — benchmark runs, comparisons, and flamegraphs — so you can investigate regressions, explore profiling results, and review performance changes without leaving your editor or chat interface. The server follows the Model Context Protocol (MCP) specification and is hosted by CodSpeed at

https://mcp.codspeed.io/mcp

Getting started

Claude Code
Claude Desktop
Cursor
Windsurf
VS Code (Copilot)

Add the CodSpeed marketplace and install the plugin:

/plugin marketplace add CodSpeedHQ/codspeed
/plugin install codspeed

Alternatively, you can add the MCP server directly:

claude mcp add --transport http CodSpeed https://mcp.codspeed.io/mcp

Claude Code will open a browser window to authenticate with CodSpeed via OAuth on first use.

Open Settings → MCP.
Click Add MCP Server.
Enter the following:
- Name: CodSpeed
- URL: https://mcp.codspeed.io/mcp
Save and authenticate with CodSpeed when prompted.

Add the following to your .cursor/mcp.json file:

.cursor/mcp.json

{
  "mcpServers": {
    "CodSpeed": {
      "url": "https://mcp.codspeed.io/mcp"
    }
  }
}

Cursor will prompt you to authenticate with CodSpeed via OAuth on first use.

Add the following to your ~/.codeium/windsurf/mcp_config.json file:

mcp_config.json

{
  "mcpServers": {
    "CodSpeed": {
      "serverUrl": "https://mcp.codspeed.io/mcp"
    }
  }
}

Add the following to your .vscode/mcp.json file:

.vscode/mcp.json

{
  "servers": {
    "CodSpeed": {
      "type": "http",
      "url": "https://mcp.codspeed.io/mcp"
    }
  }
}

Example prompts

Once connected, you can ask your AI assistant questions like:

“Explain the regression on the feat/my-great-feature branch.”
“Make my foo_bar function faster.”
“What are the hottest functions in the bench_foo benchmark?”
“Analyze the flamegraph for bench_parse and refactor the hot path.”
“Compare the flamegraphs of bench_serialize between main and feat/new-encoder and explain what changed.”
“Find the bottleneck in bench_api_handler and open a PR to fix it.”

Because the MCP server runs inside coding agents, your assistant can cross-reference flamegraph hot spots with your actual source code — then suggest or apply optimizations directly.

Available tools

The CodSpeed MCP server exposes four tools:

Tool	Description
`list_repositories`	List all CodSpeed-enabled repositories you have access to, including visibility and descriptions.
`list_runs`	List recent performance runs for a repository, with optional filters for branch, event type, and status.
`compare_runs`	Compare two performance runs and return a detailed report with regressions, improvements, and new benchmarks.
`query_flame_graph`	Query flamegraph profiling data for a specific benchmark in a run, showing hot spots and the call tree.

Authentication

The CodSpeed MCP server uses OAuth for authentication. When you first connect, your MCP client will open a browser window where you log in to CodSpeed and authorize access. The client stores the resulting token and refreshes it automatically — no API keys to manage.

The MCP server has access to the same repositories and data as your CodSpeed account.

Get Started

Instruments

Integrations

Explore Features

Getting started

Example prompts

Available tools

Authentication

Get Started

Instruments

Integrations

Explore Features

​Getting started

​Example prompts

​Available tools

​Authentication

Getting started

Example prompts

Available tools

Authentication