# TTS Library API

> Scoped excerpt of https://ttslibrary.com/llms-full.txt for agents that only need the programmatic surface, not the full language/provider documentation.

Base URL: `https://ttslibrary.com`

Public, read-only, no API key or signup required. See [/openapi.json](https://ttslibrary.com/openapi.json) for the full OpenAPI 3.1 spec and [/auth.md](https://ttslibrary.com/auth.md) for the authentication story (there isn't one - it's a free public API).

## GET /api/voices

Filters, deduplicates, and paginates the voice catalog. Query params: `search`, `providers`, `genders`, `language`, `country`, `model`, `accent`, `ages`, `limit`, `offset`. Every response carries `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset` and `X-API-Version` headers.

```bash
curl "https://ttslibrary.com/api/voices?language=Spanish&genders=Female&limit=10"
```

## GET /api/metadata

Returns all available filter values (providers, genders, languages, countries, accents) and aggregate stats, derived dynamically from the live catalog.

```bash
curl "https://ttslibrary.com/api/metadata"
```

## GET /api/audio-url

Returns a presigned audio preview URL for a voice ID.

```bash
curl "https://ttslibrary.com/api/audio-url?voiceId=AWS.Polly.Joanna-Neural"
```

## POST /api/mcp

Model Context Protocol server (Streamable HTTP, stateless). Tools: `search_voices`, `get_voice_metadata`, `get_audio_url`. Manifest at [/.well-known/mcp.json](https://ttslibrary.com/.well-known/mcp.json).

## Errors

All REST endpoints return `{ "error": { "code": "...", "message": "..." } }` on failure. Rate limit exceeded returns `429` with a `Retry-After` header.

## More

Full documentation: [/llms-full.txt](https://ttslibrary.com/llms-full.txt) · Concise overview: [/llms.txt](https://ttslibrary.com/llms.txt)