Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/mcp/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Embrace's MCP server is available to all Embrace users.
| `list_crashes` | List top crashes ranked by frequency and user impact |
| `get_crash_details` | Get detailed information about a specific crash group |
| `get_crash_stack_samples` | Fetch actual stack traces for crash analysis |
| `get_crash_distribution` | Break down crash occurrences across a dimension and compare against session baselines |

## Prerequisites

Expand Down Expand Up @@ -108,6 +109,23 @@ Deep dive into a specific crash to understand its root cause:

**Example query:** "What's causing the top crash in my app and how do I fix it?"

### Investigate crash distribution

Use `get_crash_distribution` to see where a crash is concentrated by comparing
its occurrence across a dimension against the session baseline.

1. Use `list_crashes` to find a crash group ID
2. Use `get_crash_distribution` with `group_by: "os_version"` to see which OS
versions are over-represented relative to their session share
3. Use `get_crash_distribution` with `group_by: "model"` or `group_by: "country"`
to further narrow down affected segments

**Example queries:**

- "Which device models are most affected by this crash?"
- "Is this crash happening more often on specific OS versions?"
- "Is this crash concentrated in a particular country?"

### Version-specific analysis

Focus on a particular app version:
Expand Down