# Glasstrace

> Agent-native full-stack debugging for AI-assisted web development.

## Quick Start

- npm package: @glasstrace/sdk
- MCP endpoint: https://api.glasstrace.dev/mcp (Streamable HTTP, Bearer auth)
- Recommended workflow: Install SDK → trigger error → use get_latest_error → iterate

## Authentication

- Anonymous mode: no API key needed for localhost development (gt_anon_xxx auto-generated)
- Paid tier: set GLASSTRACE_API_KEY environment variable

## MCP Tools

- get_latest_error: Most recent error trace with span tree
- get_trace: Search by URL, method, status code, time window
- get_root_cause: AI-powered root cause analysis (paid tier)
- get_test_suggestions: Regression test ideas (paid tier)
- get_session_timeline: Full session history grouped by route

## Docs

- [Getting Started](https://glasstrace.dev/getting-started): Install, init, first trace
- [SDK Reference](https://glasstrace.dev/sdk): registerGlasstrace, withGlasstraceConfig, span attributes
- [Configuration](https://glasstrace.dev/sdk/config): Environment variables, CaptureConfig, anonymous mode
- [MCP Server](https://glasstrace.dev/mcp): 5 debugging tools for AI agents
- [Browser Extension](https://glasstrace.dev/extension): Client-side correlation
- [Troubleshooting](https://glasstrace.dev/troubleshooting): Common errors and solutions
- [Auth & Keys](https://glasstrace.dev/auth): Key types, signup, upgrade path

## Documentation Sets

- [Abridged documentation](https://glasstrace.dev/llms-small.txt): a compact version of the documentation for Glasstrace, with non-essential content removed
- [Complete documentation](https://glasstrace.dev/llms-full.txt): the full documentation for Glasstrace

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation