CodSpeed for Agents: MCP Server and Skills

Investigating a regression usually means switching between your editor, the CodSpeed dashboard, and a flamegraph viewer. The CodSpeed MCP server and agent skills bring all of that into your AI assistant, so you can go from "this function is slow" to a fix without leaving your workflow.

MCP Server

The MCP server gives your AI assistant direct access to your performance data through five tools:

• Query flamegraphs: surface the functions with the highest self time, walk the call tree, and let your assistant cross-reference hot spots with your source code to suggest targeted fixes.
• Compare runs: generate a full performance report between any two runs, with benchmark-level diffs showing regressions, improvements, and new or missing benchmarks.
• Get run details: inspect a single run and its benchmark results.
• List runs: browse recent performance runs with commit, branch, and PR info.
• List repositories: see all your CodSpeed-enabled repositories.

Agent Skills

Skills teach your assistant how to act on the data. Two skills ship today:

codspeed-optimize: turns your assistant into an autonomous performance engineer. Point it at a slow function or a regression and it loops: measure, analyze the flamegraph, make a targeted change, re-measure, compare, until there is nothing left to gain.

codspeed-setup-harness: handles the initial benchmark setup. It detects your project structure, picks the right framework for your language, writes benchmarks, and verifies everything works. Supports Rust, Python, Node.js, Go, C/C++, and more.

Try it

Install the CodSpeed plugin in Claude Code to get the MCP server and skills in one step:

/plugin marketplace add CodSpeedHQ/codspeed
/plugin install codspeed

Or add the MCP server to any compatible tool separately:

npx add-mcp https://mcp.codspeed.io/mcp --name CodSpeed

And install the agent skills:

npx skills add CodSpeedHQ/codspeed

Then ask your assistant something like:

• "Make my parse_input function faster."
• "There's a regression on feat/parser, investigate and fix it."
• "Add benchmarks to this project."

Learn more about the MCP server and agent skills.