# Vaka

> Self-hosted crash reporting and analytics for agents. Crashes and errors are grouped into
> issues and symbolicated; web and mobile analytics are cookieless. There is no dashboard:
> query and triage through the REST API (https://vaka.example.com/api/v1) or the MCP server (https://vaka.example.com/mcp).

Instance: https://vaka.example.com

## Integrate an app (do this when asked to "add Vaka" or "set up crash reporting/analytics")

1. You need an API token (`vt_...`) from the person running Vaka. An all-projects write token
   can create projects.
2. Create a project: MCP tool `create_project`, or
   `POST https://vaka.example.com/api/v1/projects {"name": "...", "platform": "javascript|android|ios|rust|go|node|python|jvm|dotnet|other"}`.
   The response contains the ingest key (`vk_...`, safe to embed in apps).
3. Get the install guide with the key filled in: MCP tool `get_install_instructions`, or
   `GET https://vaka.example.com/api/v1/projects/{project}/install/{javascript|android|ios|rust|http}`.
   Follow it step by step, including the debug file upload step in the build.
4. Verify: send a test event and confirm it with `list_issues`.

- [Install: JavaScript (browser)](https://vaka.hellsoft.se/install/javascript)
- [Install: Android](https://vaka.hellsoft.se/install/android)
- [Install: iOS](https://vaka.hellsoft.se/install/ios)
- [Install: Rust](https://vaka.hellsoft.se/install/rust)
- [Install: any other language over HTTP](https://vaka.hellsoft.se/install/http)

## Investigate and fix crashes

Connect the MCP server (`https://vaka.example.com/mcp`, header `Authorization: Bearer vt_...`).
Loop: `list_issues` → `get_issue` (frames[0] is the crash site; read breadcrumbs and tags; open
the in-app frames in the repo) → fix → `resolve_issue` with `resolved_in_release` → `comment_issue`
with the fix. For "what changed" questions use `release_health`, `compare_releases` and `explain_spike`.

## Docs

- [Overview](https://vaka.hellsoft.se/index.md)
- [Quickstart](https://vaka.hellsoft.se/quickstart.md)
- [MCP server and tools](https://vaka.hellsoft.se/mcp.md)
- [REST API](https://vaka.hellsoft.se/api.md) and [OpenAPI](https://vaka.example.com/api/v1/openapi.json)
- [Ingest protocol (write your own SDK)](https://vaka.hellsoft.se/ingest.md)
- [CLI: debug file uploads](https://vaka.hellsoft.se/cli.md)
- [Alerts and webhooks](https://vaka.hellsoft.se/alerts.md)
- [Privacy, retention, user deletion](https://vaka.hellsoft.se/privacy.md)
- [Self-hosting](https://vaka.hellsoft.se/self-hosting.md)

## SDK references

- [JavaScript](https://vaka.hellsoft.se/sdk-javascript.md)
- [Android](https://vaka.hellsoft.se/sdk-android.md)
- [iOS](https://vaka.hellsoft.se/sdk-ios.md)
- [Rust](https://vaka.hellsoft.se/sdk-rust.md)
- [HTTP](https://vaka.hellsoft.se/sdk-http.md)