# Bugwatch documentation

> **For agents:** call `whoami` first, then `search_docs(query="…")` and `get_doc(slug="…")` for anything on this site. Every page here is also plain Markdown at `https://docs.bugwatch.io/<slug>.md`, and the whole site is one file at `/llms-full.txt`.

Bugwatch is error monitoring, APM, uptime, and on-call on the Cloudflare Developer Platform. It speaks the Sentry envelope protocol on ingest, so it **works with Sentry SDKs**: swap the DSN, keep your code. Everything the dashboard can do is also available to agents over MCP and to scripts over REST, with the same scoped tokens.

These docs cover the whole product: [issues](https://docs.bugwatch.io/product/issues.md), [performance](https://docs.bugwatch.io/product/performance.md), [releases](https://docs.bugwatch.io/product/releases.md) and [alerts](https://docs.bugwatch.io/product/alerts.md) for errors and traces; [uptime monitors](https://docs.bugwatch.io/product/uptime.md), [on-call schedules](https://docs.bugwatch.io/product/on-call.md), [incidents and escalation](https://docs.bugwatch.io/product/incidents.md) and [status pages](https://docs.bugwatch.io/product/status-pages.md) for staying up; [mobile notifications](https://docs.bugwatch.io/product/mobile-notifications.md); [filters and scrubbing](https://docs.bugwatch.io/product/filters-and-scrubbing.md); and billing and the MCP server. Moving from another on-call tool? See [migrating on-call](https://docs.bugwatch.io/product/migrating-on-call.md).

## Reading these docs as an agent

- **Raw Markdown:** append `.md` to any page URL, or send `Accept: text/markdown`.
- **Index:** `/llms.txt` lists every page with a one-line description. **Everything:** `/llms-full.txt`.
- **Search:** `GET /search?q=source+maps` returns JSON hits; `search_docs` does the same over MCP.
- **Tool reference:** `/reference/mcp-tools` is generated from the tool registry (also as JSON at `/mcp-tools.json`), so it cannot drift from the server.
- Each page opens with a *For agents* callout naming the tools that cover the topic.

## Where to go

| If you want to… | Read |
|---|---|
| Send your first event | [Quickstart](https://docs.bugwatch.io/quickstart.md) |
| Understand events, issues, fingerprints, sampling | [Concepts](https://docs.bugwatch.io/concepts.md) |
| Connect Claude Code, Cursor, or any MCP client | [Connect an agent](https://docs.bugwatch.io/agents/connect.md) |
| Let an agent fix, triage, or check a release | [Agent workflows](https://docs.bugwatch.io/agents/workflows.md) |
| Pick the right token scopes for an agent | [Tokens & scopes](https://docs.bugwatch.io/agents/tokens-and-scopes.md) |
| Set up an SDK for your framework | [SDKs & platforms](https://docs.bugwatch.io/sdks/overview.md) |
| Get readable stack traces from minified code | [Source maps](https://docs.bugwatch.io/sdks/source-maps.md) |
| Configure Slack, email, PagerDuty, or webhook alerts | [Alerts](https://docs.bugwatch.io/product/alerts.md) |
| Watch a URL, port, certificate, DNS record, or cron job | [Uptime monitors](https://docs.bugwatch.io/product/uptime.md) |
| Call the REST API directly | [REST API](https://docs.bugwatch.io/api/rest.md) and [Authentication](https://docs.bugwatch.io/api/authentication.md) |
| Understand plans, quotas, and overage | [Billing & quotas](https://docs.bugwatch.io/account/billing-and-quotas.md) |

## Endpoints

| Surface | URL |
|---|---|
| Dashboard | `https://app.bugwatch.io` |
| REST API | `https://api.bugwatch.io/v1/…` |
| MCP server | `POST https://api.bugwatch.io/mcp` |
| Ingest (DSN host) | `https://ingest.bugwatch.io` |
| Docs | `https://docs.bugwatch.io` |