Telebugs

Telebugs

Reference for working with Telebugs MCP tools. Tools are deferred and must be loaded before use. Report responses are large and need structured extraction.

Loading Tools

Tools are deferred MCP tools — load them via ToolSearch before calling:

ToolSearch: "+telebugs get error report"
ToolSearch: "+telebugs list reports"

URL Pattern

Telebugs URLs follow: https://<your-telebugs-host>/errors/{group_id}/reports/latest

• Extract group_id from the URL path
• There is no "latest report" API — fetch via list_reports with group_id and limit: 1

Data Model

• Error group: deduplicated errors with occurrence count, notes, status. Small response (~5KB).
• Report: single error occurrence with full stack traces, breadcrumbs, context. Large response (30-50KB+).

Fetching Data

Fetch error group and latest report list in parallel:

mcp__telebugs__get_error_group(group_id)
mcp__telebugs__list_reports(group_id, limit: 1)

The error group response includes notes from team members — read these first for context. Then get the full report using the report ID from the list:

mcp__telebugs__get_report(report_id)

Parsing Large Report Responses

The get_report response is saved to a file as: [{type: "text", text: "<nested JSON>"}].

Do NOT try to Read the file directly — it exceeds token limits. Use Bash with Python to extract each section separately:

Error details — what broke, when, how often:

cat RESULT_FILE | python3 -c "
import json, sys
data = json.load(sys.stdin)
report = json.loads(data[0]['text'])['report']
print(f\"Error: {report['error_type']}\")
print(f\"Message: {report['error_message'][:500]}\")
print(f\"Environment: {report['environment']}\")
print(f\"Occurred: {report['occurred_at']}\")
print(f\"Server: {report['server']}\")
print(f\"Release: {report['release']}\")
print(f\"Severity: {report['severity']}\")
print(f\"Handled: {report['handled']}\")
"

Stack traces — where it broke (all chained exceptions):

cat RESULT_FILE | python3 -c "
import json, sys
data = json.load(sys.stdin)
report = json.loads(data[0]['text'])['report']
for i, st in enumerate(report.get('stack_traces', [])):
    print(f'=== EXCEPTION {i}: {st.get(\"exception_type\")} ===')
    print(st.get('exception_value', '')[:500])
    for j, frame in enumerate(st.get('frames', [])):
        marker = ' *' if frame.get('in_app') else ''
        print(f'  {j}: {frame[\"file\"]}:{frame[\"line\"]} in {frame[\"function\"]}{marker}')
        if frame.get('context_line') and frame.get('in_app'):
            print(f'     > {frame[\"context_line\"].strip()}')
"

Focus on frames marked * — those are your code (in_app: 1), not gems/libraries.

Breadcrumbs — what happened right before the error:

cat RESULT_FILE | python3 -c "
import json, sys
data = json.load(sys.stdin)
report = json.loads(data[0]['text'])['report']
for b in report.get('breadcrumbs', []):
    cat = b.get('category', '')
    data_str = json.dumps(b.get('data', {}), default=str)[:200]
    print(f'[{b.get(\"timestamp\")}] {cat} {data_str}')
"

Tags, context, request, user — additional metadata:

cat RESULT_FILE | python3 -c "
import json, sys
data = json.load(sys.stdin)
report = json.loads(data[0]['text'])['report']
for key in ['tags', 'contexts', 'request', 'user']:
    val = report.get(key)
    if val:
        print(f'=== {key} ===')
        print(json.dumps(val, indent=2, default=str)[:1000])
"

Quick Reference

Common Mistakes