# Superscribe

> Voice-to-text SaaS with automated time tracking. Capture audio on any platform, get instant transcripts, search your recording history.

Superscribe records voice via microphone, file upload, or phone call, transcribes it in real-time using ElevenLabs Scribe, and automatically tracks time for billing and reporting. Users can search recordings semantically, generate reports, and export data.

## Docs

- [API Reference](https://superscribe.io/api/docs): Interactive REST API documentation
- [OpenAPI Spec](https://superscribe.io/api/v1/openapi.json): Machine-readable OpenAPI 3.0 JSON spec

## REST API

Base URL: `https://superscribe.io/api/v1`

All endpoints require an `x-api-key` header with an `ss_` API key.
Keys are created at https://superscribe.io/dashboard/api

### Endpoints

- `GET /recordings` — List recordings (paginated). Params: `page`, `limit` (max 100), `dateFrom`, `dateTo`, `source`, `sortBy`, `sortOrder`
- `GET /recordings/search?q=` — Search transcripts. Uses semantic vector search, falls back to text. Params: `q` (required), `page`, `limit` (max 50)
- `GET /recordings/:id` — Get a single recording by ID

### Recording object

```json
{
  "id": "507f1f77bcf86cd799439011",
  "transcript": "The meeting discussed Q4 targets...",
  "duration_seconds": 142,
  "source": "microphone",
  "language": "en",
  "was_translated": false,
  "mode_id": null,
  "direction": null,
  "caller_number": null,
  "callee_number": null,
  "caller_name": null,
  "turns": null,
  "created_at": "2025-03-01T10:30:00.000Z",
  "updated_at": "2025-03-01T10:30:01.000Z"
}
```

## MCP (Model Context Protocol)

Endpoint: `https://superscribe.io/mcp`
Protocol: Streamable HTTP (POST)
Auth: `x-api-key` header with an `ss_` API key

### Tools

- `get_recordings` — List recordings. Args: `limit`, `dateFrom`, `dateTo`, `source`
- `get_recording` — Fetch one recording by ID. Args: `id` (required)
- `search_recordings` — Search transcripts. Args: `query` (required), `limit`

### Claude Desktop config

```json
{
  "mcpServers": {
    "superscribe": {
      "url": "https://superscribe.io/mcp",
      "headers": { "x-api-key": "ss_YOUR_KEY" }
    }
  }
}
```

## Authentication

API keys start with `ss_` and are scoped to the creating user's data.
Create keys at: https://superscribe.io/dashboard/api