# Raconte for developers and agents

Raconte runs AI voice interviews. One organization API key drives every surface below,
created by a human in the app under Settings > API.

## Authenticate

- Prose walkthrough: https://raconte.ai/auth.md
- Protected resource metadata (RFC 9728): https://api.raconte.ai/.well-known/oauth-protected-resource
- Any call without a key answers 401 with a `WWW-Authenticate` header naming that document.
- Header: `Authorization: Bearer YOUR_API_KEY` (`x-api-key` accepted).

## Call

- REST API: `https://api.raconte.ai/v1`, 300 requests per minute per key.
- OpenAPI 3.1 specification: https://raconte.ai/openapi.json
- MCP server (Streamable HTTP): `https://api.raconte.ai/api/mcp`. The handshake and `tools/list` are open; tool calls need a key.
- CLI: `npx @raconte/cli`. TypeScript SDK: `@raconte/node-sdk`.

## Discover

- Site index for LLMs: https://raconte.ai/llms.txt
- API catalog (RFC 9727): https://raconte.ai/.well-known/api-catalog
- Agentic Resource Discovery catalog: https://raconte.ai/.well-known/ai-catalog.json
- MCP server card: https://raconte.ai/.well-known/mcp/server-card.json
- Agent Skills index: https://raconte.ai/.well-known/agent-skills/index.json
- Agent skill for the CLI: https://raconte.ai/skill.md
- Machine-readable pricing: https://raconte.ai/pricing.md

## Read

- [Developer portal](https://raconte.ai/en/developers): keys, surfaces, quickstart, rate limits, versioning policy, error shapes
- [REST API reference](https://raconte.ai/en/docs/api)
- [Interactive reference](https://raconte.ai/en/docs/api-reference)
- [MCP server](https://raconte.ai/en/docs/mcp) and its [setup guide](https://raconte.ai/en/guides/mcp-setup)
- [Webhooks](https://raconte.ai/en/docs/webhooks)
- [SDK](https://raconte.ai/en/docs/sdk) and [CLI](https://raconte.ai/en/docs/cli)

Every page has a markdown twin: append `.md` to its URL, or send `Accept: text/markdown`.