V8 MCP Server

MCP server that decodes V8 CPU profiles into token-efficient bottleneck summaries for AI agents

Local serverstdioTypeScript

What is the V8 MCP Server?

MCP server that decodes V8 CPU profiles into token-efficient bottleneck summaries for AI agents

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
extract_hottest_functionsParses the .cpuprofile and returns the top N functions ranked by exclusive CPU time (self time). Filters out V8 internals and Node.js built-ins — only user code.
analyze_call_tree_pathFinds all callers of a specific function and shows how often each one invoked it. Accepts partial, case-insensitive function name matching.
correlate_source_codeMaps compiled JS bottlenecks back to their **original TypeScript source locations** using .js.map files. Falls back gracefully to compiled JS locations if no source map is found.
analyze_gc_pressureReports garbage collection overhead as a percentage of profiling duration, broken down by GC type. Flags when GC exceeds a configurable threshold and provides a targeted recommendation.
diff_profilesCompares two .cpuprofile files (before/after an optimization) and returns per-function CPU time deltas, normalized against each profile's total duration. Frames are matched by call-frame coordinates, not transient node I
analyze_async_bottlenecksDetects event-loop overhead by identifying V8 internal frames representing async machinery — microtask queue processing, nextTick saturation, and timer/immediate callbacks.

How to install the V8 MCP Server

{
  "mcpServers": {
    "v8-cpu-profile-decoder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "v8-cpu-profile-decoder-mcp"
      ]
    }
  }
}

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

Example prompts to try

  • “Use V8 to extract hottest functions.”
  • “Use V8 to analyze call tree path.”
  • “Use V8 to correlate source code.”

Frequently asked questions

MCP server that decodes V8 CPU profiles into token-efficient bottleneck summaries for AI agents Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.