# AGENTS.md — Listnr AI

The agent contract for `https://listnr.ai`. This file describes **what exists today**.
Anything not listed here does not exist yet — do not assume it does.

- Canonical host: `https://listnr.ai` (no `www`, no trailing slash, query-free URLs)
- Product: AI text-to-speech, voice cloning, translation, and dubbing
- Support: support@listnr.ai
- Last updated: 2026-09-11

## Start here

| Purpose | URL | Type |
| --- | --- | --- |
| Compact machine index | https://listnr.ai/llms.txt | `text/plain` |
| Markdown homepage | https://listnr.ai/index.md | `text/markdown` |
| Evidence-dated facts | https://listnr.ai/ai-info | `text/html` |
| Agent card (JSON or markdown) | https://listnr.ai/agent | negotiated |
| Full URL inventory | https://listnr.ai/sitemap.xml | `application/xml` |
| Machine feeds | https://listnr.ai/schema-map.xml | `application/xml` |
| RFC 9727 linkset | https://listnr.ai/.well-known/api-catalog | `application/linkset+json` |
| Resource discovery | https://listnr.ai/.well-known/ard.json | `application/json` |
| Capability catalog | https://listnr.ai/.well-known/ai-catalog.json | `application/json` |

## Browsing without a JavaScript runtime

Marketing pages render their H1, FAQ, prices, and navigation in **server HTML**, so a
plain `GET` is enough to extract the meaningful content.

- `GET /` returns HTML for all user agents. Fetch `/index.md` explicitly for markdown.
- `GET /?mode=agent` returns the agent card.
- Send `Accept: text/markdown` to negotiate markdown on machine routes.
- Unknown URLs return **HTTP 404**. For AI user agents the body is a markdown 404 with
  recovery links; everyone else gets the normal HTML 404 page.

## Content usage

- `search` = **yes** — indexing and citation are welcome.
- `ai-input` = **yes** — retrieval and grounding are welcome.
- `ai-train` = **no** — training and fine-tuning are not permitted.

Declared in `robots.txt` (Content Signals) and mirrored in the `Content-Usage` response
header (`train-ai=n, search=y`).

## API

The public REST API is real and documented for humans here:

- Overview, API-key signup, and authentication: https://listnr.ai/developer/ai-voice-api
- Reference SDK code: https://github.com/team-listnr/text-to-speech-api
- Free tier: 100 requests/day, no credit card required

**Not published** (so do not look for it): an OpenAPI/Swagger specification, a sandbox or
trial key, an OAuth flow, or an MCP server. API keys are issued through the developer
page above. Exact request headers and error codes are documented there — this file does
not restate them, because they can change without notice.

## Contact

- Support and integration questions: support@listnr.ai
- Corrections to these machine documents: support@listnr.ai

## Verified integration entry points

- Developer overview: https://listnr.ai/developers
- TTS authentication guide: https://listnr.ai/auth.md
- Pricing: https://listnr.ai/pricing.md
- Public agent repository: https://github.com/team-listnr/text-to-speech-api
- Studio discovery MCP: https://studio.listnr.ai/mcp (catalog, pricing and docs; no video generation).
- Studio OpenAPI: https://studio.listnr.ai/openapi.json