# Trace Processor

> Managing and querying Perfetto traces using the trace_processor MCP server.

- Skill: `v8/trace-processor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add v8/trace-processor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/v8/trace-processor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: v8 (https://skillmd.com/u/v8)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/v8/trace-processor

---


# Trace Processor

The `trace_processor` extension launches a long-running FastMCP server wrapping
Perfetto's trace processor capabilities, allowing seamless interaction with
trace files (`.pftrace`, `.perfetto-trace`, `.pb`).

## Writing PerfettoSQL and Schema Analysis

For comprehensive guidance on querying traces, utilizing standard library
modules, and schema structures, refer directly to the native Perfetto AI skills
inside `third_party/perfetto/ai/skills`:

- **Querying Traces**: See the
  [perfetto querying traces](/third_party/perfetto/ai/skills/perfetto/infra-references/querying.md)
  skill.
- **Common SQL Tables**: Explore standard table definitions such as `slice`,
  `thread`, `process`, `sched_slice`, and `track`.
- **Perfetto Standard Library**: Utilize standard library modules like
  `slices.with_context` by starting queries with `INCLUDE PERFETTO MODULE`.

## Official Perfetto References

- Trace Processor reference:
  <https://perfetto.dev/docs/analysis/trace-processor>
- Generated SQL Tables: <https://perfetto.dev/docs/analysis/sql-tables>
- Standard Library Documentation:
  <https://perfetto.dev/docs/analysis/stdlib-docs>