# Flameox MCP server

> Provides coding agents with bounded local runtime evidence by coordinating profilers, benchmark tools, and trace processors.

- Repository: https://github.com/morluto/flameox
- Page: https://hostedmcp.org/servers/morluto/flameox
- Transport: stdio
- Stars: 243
- License: MIT
- Latest version: 0.2.9

## Install

### Claude Code

```sh
claude mcp add flameox -- uvx flameox
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "flameox": {
      "command": "uvx",
      "args": [
        "flameox"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "flameox": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "flameox"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"flameox","type":"stdio","command":"uvx","args":["flameox"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "flameox": {
      "command": "uvx",
      "args": [
        "flameox"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add flameox -- uvx flameox
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.flameox]
command = "uvx"
args = ["flameox"]
```

### Gemini CLI

```sh
gemini mcp add -s user flameox uvx -- flameox
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "flameox": {
      "command": "uvx",
      "args": [
        "flameox"
      ]
    }
  }
}
```

## Tools (51)

- `summarize_trace`: Summarize bounded execution-trace evidence. Read existing perfetto, chrome-trace, otlp, nsys-rep, nsys-parquet, pytorch, rocprof-pftrace, xctrace artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_trace_call_graph`: Project bounded caller-callee edges from Chrome, Perfetto, or PyTorch traces. Read existing perfetto, chrome-trace, pytorch artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_pytorch_trace`: Summarize bounded PyTorch operator and event evidence. Read existing perfetto, chrome-trace, pytorch artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_trace_operations`: Summarize bounded operation timing from OTLP or Nsight Systems traces. Read existing otlp, nsys-rep, nsys-parquet artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_trace_lifecycle`: Summarize bounded execution lifecycle events from OTLP or Nsight Systems traces. Read existing otlp, nsys-rep, nsys-parquet artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_trace_window`: Read a bounded trace time window. Read existing perfetto, chrome-trace, pytorch, otlp artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `rank_cpu_hotspots`: Rank bounded CPU evidence. Read existing cpuprofile, pstats, py-spy, perf, perf-data artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_cpu_callers`: Project bounded caller-callee edges from pstats or sampled py-spy stacks. Sample weights are not deterministic invocation counts. Read existing pstats, py-spy artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `rank_allocation_hotspots`: Rank bounded allocation hotspots from Memray or V8 sampling heap profiles. Read existing memray, heapprofile artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `rank_retained_memory`: Rank bounded retained-memory evidence from a Memray capture. Read existing memray artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_benchmarks`: Summarize bounded benchmark latency measurements. Read existing pyperf, samples, nvbench artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `analyze_benchmark_scaling`: Estimate how benchmark measurements scale across a declared numeric input axis. Read existing pyperf, samples, nvbench artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `compare_benchmarks`: Compare compatible benchmark artifacts. Read existing pyperf, samples, nvbench artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_inference`: Summarize bounded inference-export measurements. Read existing aiperf, vllm-benchmark, sglang-benchmark, mooncake-trace artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `compare_inference`: Compare compatible prompt-free inference measurements. Read existing aiperf, vllm-benchmark, sglang-benchmark, mooncake-trace artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_gpu_launches`: Summarize GPU launch evidence. Read existing nsys-rep, nsys-parquet artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_gpu_kernel_metrics`: Summarize GPU kernel metrics. Read existing nsight-compute artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_triton_autotune`: Summarize Triton autotune events or native configuration-timing caches. Read existing triton, triton-cache artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_sanitizer_failures`: Summarize Compute Sanitizer failures. Read existing compute-sanitizer artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_kernel_validation`: Summarize semantic kernel validation results. Read existing kernel-validation artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `compare_kernel_validation`: Compare compatible kernel evidence. Read existing kernel-validation artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_failures`: Summarize bounded reliability evidence. Read existing pytest, observations artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_pytest_fixtures`: Rank bounded pytest fixture setup and finalizer evidence. Read existing pytest artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `summarize_coverage`: Summarize native coverage.py evidence. Read existing coverage artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `inspect_performance_candidates`: Normalize performance candidates from an existing SARIF report. Read existing sarif artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `preview_artifact`: Preview a bounded artifact without mutation. Read existing json, jsonl, csv, text, parquet artifacts; returns input identities, metrics/rows, coverage and limitations. Follow next_page for more evidence; preserve_evidence makes it durable. (read-only)
- `capture_and_summarize_trace`: Execute an explicit argv target and collect native artifacts to: Summarize bounded execution-trace evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_trace. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_trace_call_graph`: Execute an explicit argv target and collect native artifacts to: Project bounded caller-callee edges from Chrome, Perfetto, or PyTorch traces. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_trace_call_graph. Pagination reads captured artifacts without executing again.
- `capture_and_summarize_pytorch_trace`: Execute an explicit argv target and collect native artifacts to: Summarize bounded PyTorch operator and event evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_pytorch_trace. Pagination reads captured artifacts without executing again.
- `capture_and_summarize_trace_operations`: Execute an explicit argv target and collect native artifacts to: Summarize bounded operation timing from OTLP or Nsight Systems traces. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_trace_operations. Pagination reads captured artifacts without executing again.
- `capture_and_summarize_trace_lifecycle`: Execute an explicit argv target and collect native artifacts to: Summarize bounded execution lifecycle events from OTLP or Nsight Systems traces. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_trace_lifecycle. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_trace_window`: Execute an explicit argv target and collect native artifacts to: Read a bounded trace time window. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_trace_window. Pagination reads captured artifacts without executing again.
- `capture_and_rank_cpu_hotspots`: Execute an explicit argv target and collect native artifacts to: Rank bounded CPU evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use rank_cpu_hotspots. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_cpu_callers`: Execute an explicit argv target and collect native artifacts to: Project bounded caller-callee edges from pstats or sampled py-spy stacks. Sample weights are not deterministic invocation counts. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_cpu_callers. Pagination reads captured artifacts without executing again.
- `capture_and_rank_allocation_hotspots`: Execute an explicit argv target and collect native artifacts to: Rank bounded allocation hotspots from Memray or V8 sampling heap profiles. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use rank_allocation_hotspots. Pagination reads captured artifacts without executing again.
- `capture_and_rank_retained_memory`: Execute an explicit argv target and collect native artifacts to: Rank bounded retained-memory evidence from a Memray capture. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use rank_retained_memory. Pagination reads captured artifacts without executing again.
- `capture_and_summarize_benchmarks`: Execute an explicit argv target and collect native artifacts to: Summarize bounded benchmark latency measurements. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_benchmarks. Pagination reads captured artifacts without executing again.
- `capture_and_analyze_benchmark_scaling`: Execute an explicit argv target and collect native artifacts to: Estimate how benchmark measurements scale across a declared numeric input axis. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use analyze_benchmark_scaling. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_gpu_launches`: Execute an explicit argv target and collect native artifacts to: Summarize GPU launch evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_gpu_launches. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_gpu_kernel_metrics`: Execute an explicit argv target and collect native artifacts to: Summarize GPU kernel metrics. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_gpu_kernel_metrics. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_triton_autotune`: Execute an explicit argv target and collect native artifacts to: Summarize Triton autotune events or native configuration-timing caches. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_triton_autotune. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_sanitizer_failures`: Execute an explicit argv target and collect native artifacts to: Summarize Compute Sanitizer failures. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_sanitizer_failures. Pagination reads captured artifacts without executing again.
- `capture_and_summarize_failures`: Execute an explicit argv target and collect native artifacts to: Summarize bounded reliability evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_failures. Pagination reads captured artifacts without executing again.
- `capture_and_inspect_pytest_fixtures`: Execute an explicit argv target and collect native artifacts to: Rank bounded pytest fixture setup and finalizer evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use inspect_pytest_fixtures. Pagination reads captured artifacts without executing again.
- `capture_and_summarize_coverage`: Execute an explicit argv target and collect native artifacts to: Summarize native coverage.py evidence. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use summarize_coverage. Pagination reads captured artifacts without executing again.
- `capture_and_preview_artifact`: Execute an explicit argv target and collect native artifacts to: Preview a bounded artifact without mutation. Returns immediate evidence and execution provenance, including failed attempts. For existing artifacts use preview_artifact. Pagination reads captured artifacts without executing again.
- `prepare_providers`: Use when a provider result requests dependency preparation. Install the requested managed dependencies, then follow activation or reconnect guidance before retrying. Host profilers and workload-interpreter requirements receive guidance rather than installation.
- `preserve_evidence`: Keep a live analysis beyond eviction or shutdown. Publish its native artifacts and provenance as immutable evidence, returning an evidence ID and refreshed next_page when available.
- `rescue_evidence`: Use when the active evidence store needs recovery or a live analysis needs a distinct store. Publish into an explicit new evidence directory and return its restart handoff; the active store stays selected. Already-preserved captures use their immutable sources.
- `query_evidence`: Find preserved evidence after a session ends. Search immutable manifest metadata with typed filters and rows, then call inspect_evidence for replay sources. Reports inventory coverage and a next_page when more matches exist. (read-only)
- `inspect_evidence`: Read one preserved evidence ID. Returns validated, redacted manifest metadata and ordered analysis_sources inline. Pass those sources unchanged to a named analysis tool to replay the saved artifacts without recapturing. Native payload bytes stay local. (read-only)

## FAQ

### Does Flameox require a project workspace to be initialized?

No, Flameox does not require a workspace to be initialized or project configuration to be maintained; you simply pass exact artifact paths or explicit commands.

### Can I choose where Flameox stores its data?

Yes, you can set the FLAMEOX_DATA_DIR environment variable to choose a different location for the user-level Flameox data directory.
