# Earshot

> Voice-first feedback widget. Captures a voice memo + screenshot + DOM + console + network + identity + federated session replay, runs a clarifying agent grounded in the host project, and files a structured ticket to Linear or Jira. Every capability is also an MCP tool.

## Docs

- [Quickstart](http://localhost:3002/docs/quickstart): Install Earshot in under 5 minutes (human or agent-driven).
  - raw markdown: http://localhost:3002/docs/quickstart/raw.md
- [Concepts](http://localhost:3002/docs/concepts): Projects, feedback, sessions, federation, trackers.
  - raw markdown: http://localhost:3002/docs/concepts/raw.md
- [Widget](http://localhost:3002/docs/widget): Install snippet, Earshot.init options, identify / reset / open, capture model.
  - raw markdown: http://localhost:3002/docs/widget/raw.md
- [Cursor](http://localhost:3002/docs/cursor): Connect Cursor to the Earshot MCP and let Cursor install the widget into your app.
  - raw markdown: http://localhost:3002/docs/cursor/raw.md
- [Dashboard](http://localhost:3002/docs/dashboard): Inbox, detail page, status workflow, comments, project switcher.
  - raw markdown: http://localhost:3002/docs/dashboard/raw.md
- [Integrations](http://localhost:3002/docs/integrations): Federation (PostHog / Sentry / LogRocket / Datadog) and trackers (Linear / Jira). Security model + setup.
  - raw markdown: http://localhost:3002/docs/integrations/raw.md
- [Project context](http://localhost:3002/docs/project-context): Push a brief about your app so the enrichment LLM reasons about real routes, glossary, and known issues.
  - raw markdown: http://localhost:3002/docs/project-context/raw.md
- [MCP](http://localhost:3002/docs/mcp): Hosted MCP server with OAuth 2.1 DCR. 17 tools — feedback, project context, integrations, user-scoped admin.
  - raw markdown: http://localhost:3002/docs/mcp/raw.md
- [REST API](http://localhost:3002/docs/api): /v1/feedback, /v1/identify, PATCH, comments. Authn via x-earshot-key.
  - raw markdown: http://localhost:3002/docs/api/raw.md
- [Security](http://localhost:3002/docs/security): Auth model, encryption at rest, RLS, data handling, privacy choices.
  - raw markdown: http://localhost:3002/docs/security/raw.md
- [Self-hosting](http://localhost:3002/docs/self-hosting): Run Earshot against your own Supabase + Vercel. Env vars, migrations, local dev.
  - raw markdown: http://localhost:3002/docs/self-hosting/raw.md
- [Agents](http://localhost:3002/docs/agents): Why Earshot treats agents as a first-class persona, and what that means in practice.
  - raw markdown: http://localhost:3002/docs/agents/raw.md

## MCP

- MCP server: https://mcp.earshot.dev/mcp
- OAuth metadata: http://localhost:3002/oauth/.well-known/oauth-authorization-server