llms.txt Content
# Chamade
> Voice and chat gateway for AI agents. Chamade joins meetings, phone calls, and DMs across 10 platforms and runs the speech pipeline for you using your own STT/TTS provider key (BYOK) — or hands you raw PCM on a WebSocket if you'd rather run the speech layer yourself.
Authenticate with an API key (`chmd_...`), tell Chamade to join on Discord / Teams / Meet / SIP / NC Talk / Zoom / Telegram / WhatsApp / Slack / Matrix, and speech + chat just work.
Two key kinds (both `chmd_*`): an **agent key** runs the agent (join calls, send DMs, read the inbox) — it's the bearer you put in the MCP config; a **settings key** configures the account by API (agents, providers, platforms, voice). The runtime key cannot reconfigure the account, and the config key cannot act on the control-plane — see "Authentication" in the full docs.
- **Voice — hosted STT/TTS (recommended, BYOK)**: add your ElevenLabs / Deepgram key in /dashboard → Voice providers once; Chamade runs the pipeline server-side (free — you pay your provider, not Chamade). Transcripts arrive as `call_transcript` events, `chamade_call_say` speaks into the meeting.
- **Voice — raw PCM WebSocket (alternative)**: if you'd rather run the speech layer in-process (OpenAI Realtime, LiveKit Agents, Pipecat, Deepgram, manual cascade, …), Chamade exposes the call's raw PCM audio bidirectionally. Useful when you have a voice pipeline you want to keep.
- **Text conversations** (DMs, group chats, in-call chat): fully plug-and-play via the REST API or MCP tools. Send and receive text, handle typing indicators, read the inbox — zero audio plumbing needed.
- **File attachments**: send + receive on Discord, Telegram, Slack, Matrix, WhatsApp (incl. voice notes), NC Talk. Pass `attachments: [{file_id} | {url} | {bytes_b64, name, mime}]` on `chamade_dm_chat` / `chamade_call_chat`; agents get upload URLs via `chamade_file_upload_url` or `POST /api/files`. 25 MB cap per file. Teams + Meet code-ready, waiting on c
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"Chamade","version":"0.1.0"},"paths":{"/auth/signup":{"post":{"tags":["auth"],"summary":"Signup","operationId":"signup_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/sche