List bugs for the organization (flat, one row per deduplicated report). Supports filtering by status, severity, project, platform, deliveryFeed (all | urgent_critical | ui_ux), and text search. Each row includes affected_user_count, repeat_user_count, and user_spread (user_specific vs widespread). Diagnostic-class signals are excluded by default. Prefer list_bug_groups for grouped triage.
ParameterslimitoffsetsearchstatusplatformseverityprojectIddeliveryFeed
Get full details of a bug including title, description, severity, status, reporters, AI summary, environment info, report count, affected_user_count, repeat_user_count, and user_spread (user_specific vs widespread). Use get_bug_users for the per-user roster.
ParametersbugIdrequired
get_bug_events
Read captured events
Get session events for a bug (DOM, network, console, clicks, errors). Prefer passing occurrenceId so events are not mixed across captures.
ParameterstypebugIdrequiredlimitoffsetoccurrenceId
get_repro_context
Read issue evidence
Build an agent-consumable reproduction pack: evidence (timeline, status, env) separate from inference (AI summary). Prefer occurrenceId so sessions are not interleaved. Not raw rrweb. Same pack as resources/read bugtape://bugs/{bugId}/repro.
ParametersbugIdrequiredeventLimitoccurrenceId
list_projects
List projects
List all projects in the organization with their bug counts.
Takes no parameters.
get_project_stats
Get Project Stats
Get aggregate statistics for a project (server-computed over bugs in the elected delivery feed, not a sample): counts by status and severity, daily timeline, top unresolved bugs by report count, MTTR, health score, and previous-period comparison.
ParametersdaysprojectIdrequireddeliveryFeed
get_bug_occurrences
Get Bug Occurrences
List the individual occurrences grouped under a bug. Use this to see which users, sessions, releases, or environments were affected.
ParametersbugIdrequiredlimitoffset
get_bug_users
Get Bug Users
Who hit this bug: one row per affected end user (the app's identify() userId, else reporter email, else an anonymous IP-hash key) with firstSeen, lastSeen, occurrenceCount, platforms (web/ios/…), lastRelease and lastOccurrenceId. Pass a row's userKey to get_user_timeline to see everything that user experienced across bugs, or to get_repro_context via occurrenceId=lastOccurrenceId.
ParametersbugIdrequiredlimitoffset
get_live_occurrences
Get Live Occurrences
Get the most recent occurrences across the organization. Useful for live monitoring and tester workflows. Honors deliveryFeed (tool arg, else PAT / project).
ParameterslimitdeliveryFeed
get_current_org
Current workspace
Return the credential workspace. Agent PATs resolve only their own workspace; human sessions use BUGTAPE_ORG_ID.
Takes no parameters.
get_bug_history
Get Bug History
Get the full audit trail of status/severity changes and assignments on a bug, including who changed what and when.
ParametersbugIdrequired
get_similar_bugs
Get Similar Bugs
Find other bugs similar to the given bug, ranked by similarity score (0-100, fingerprint + title overlap). Returns up to 5 matches. Useful before merging or triaging.
ParametersbugIdrequired
list_bug_groups
List Bug Groups
Grouped triage view: bugs collapsed across pages by error signature (one group per distinct error within a project, even when dedup created many bug rows). Each group includes projectId + groupKey (the stable group identity), a representative sampleBugId/sampleTitle, instanceCount, occurrenceCount, sessionCount, userCount, maxSeverity, topStatus, signalReason (why the classifier flagged it), browsers/oses, platforms (web/ios/android/react-native/flutter/server — one issue can span several), and anyRegression. Pass both projectId and groupKey as one groupRefs entry to bulk_update_bugs. Legacy groupKeys are accepted only when unique across the organization and are rejected when ambiguous. Prefer this over list_bugs for triage.
ParameterssortlimitoffsetsearchstatusassigneeplatformseveritydirectionprojectIdunresolveddeliveryFeed
list_recommended_critical
Find urgent issues
Start here. Returns `sentToYou` first: bugs a person sent you with "Send to agent" (fix these first), then the prefiltered agent inbox: one row per signature group, new unique issues scored critical/high (or regressions). `id` is the best qualifying member. `member_id_sample` is at most 8 member ids; `instance_count` is the full count and `instances_path` lists the rest. Use this instead of list_bugs for what to work on. Diagnostic, silenced, and agent-acked rows are excluded.
ParameterslimitsinceprojectId