perfetto-mcp

perfetto-mcp is a local Model Context Protocol (MCP) server that turns natural-language prompts into Perfetto trace analyses (including generating PerfettoSQL) for tasks like jank/ANR detection, CPU hotspot analysis, lock contention, Binder transaction profiling, and memory leak signals.

Evaluated Mar 30, 2026 (21d ago)
Repo ↗ Ai Ml mcp perfetto android-tracing observability profiling debugging perfetto-sql agent-tools
⚙ Agent Friendliness
56
/ 100
Can an agent use this?
🔒 Security
23
/ 100
Is it safe for agents?
⚡ Reliability
26
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
72
Documentation
70
Error Messages
0
Auth Simplicity
95
Rate Limits
0

🔒 Security

TLS Enforcement
0
Auth Strength
10
Scope Granularity
0
Dep. Hygiene
55
Secret Handling
60

No network interface or TLS/auth is described; the server runs locally via stdio. This reduces remote attack surface, but increases risk from any tools that may read local trace files (sensitive data). No explicit guidance on sandboxing, trace file validation, logging of sensitive data, or handling of malicious trace contents is provided. Dependencies include mcp[cli], perfetto, protobuf<5, which may warrant dependency/CVE review before use in sensitive environments.

⚡ Reliability

Uptime/SLA
0
Version Stability
45
Breaking Changes
40
Error Recovery
20
AF Security Reliability

Best When

You have one or more Perfetto trace files locally and want an agent to orchestrate analysis by calling MCP tools that return structured JSON results.

Avoid When

You need authentication/authorization controls, network-access APIs, or strict compliance claims without additional vetting; also avoid untrusted trace content ingestion in sensitive environments without sandboxing.

Use Cases

  • Analyze Android Perfetto traces via natural-language requests
  • Diagnose jank (missing frame deadlines) and summarize frame performance
  • Detect and investigate ANR events and likely root causes
  • Identify CPU hot threads/scheduling hotspots
  • Find lock contention / thread synchronization bottlenecks
  • Profile Binder IPC latency and group slow transactions
  • Detect suspected memory leak patterns and heap dominators

Not For

  • Using as a hosted SaaS/API service (it appears intended to run locally as an MCP stdio server)
  • Production workflows requiring guaranteed, reproducible analysis without validation of generated SQL
  • Scenarios where you cannot provide local trace files (requires trace_path as input)

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: No explicit auth described (local stdio MCP server)
OAuth: No Scopes: No

README describes running the MCP server locally (e.g., uvx/uv) and provides required tool parameters (trace_path, process_name). No user authentication mechanism is documented, suggesting it runs without auth in a local developer environment.

Pricing

Free tier: No
Requires CC: No

No pricing information; appears to be an open-source package executed locally.

Agent Metadata

Pagination
none
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • Tool inputs require absolute trace_path and a process_name; incorrect paths/process names may yield empty or failed analyses.
  • Generated SQL/tool behavior depends on the trace containing the relevant events (e.g., ANRs); prompts should constrain time ranges and expectations.
  • Because it is a local MCP stdio server, agents need to launch it correctly (command/args) per client (Cursor/Claude/Copilot/etc.).

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for perfetto-mcp.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-30.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered