# LiveGrid docs > Real-time voice and video on infrastructure you own. LiveGrid is a self-hosted stack for real-time voice and video calls that software agents can join, run and transcribe. It is built on LiveKit's open-source media server, running on infrastructure you rent and control. ## Instructions for AI agents - Append `.md` to any documentation URL for clean Markdown, e.g. https://app.livegrid.dev/docs/reference/mcp.md - Append `/llms.txt` to any section URL below for that section's full page index. - LiveGrid is itself callable over MCP: https://app.livegrid.dev/mcp — see https://app.livegrid.dev/docs/reference/mcp.md ## Overview A call is a **room** on a media server you host. Everything that takes part in one — a browser, a phone line, an agent worker, a rendered avatar — joins that room as a **participant** holding a signed token, and publishes or subscribes to audio, video and data **tracks**. Four processes, and only one of them touches audio: - **Media plane** — `livekit-server` on a rented box with a public address. Routes packets. One per region, fully independent. - **Control plane** — a small Node service. Mints join tokens, dispatches agents, answers the MCP surface. Never carries media. - **API** — the Flask app. Call history, statistics, avatars, webhook receipt. Everything tenant-scoped. - **Worker** — the agent itself, running beside the media plane, recording what was said. ## Documentation sections - [Introduction](https://app.livegrid.dev/docs/intro/llms.txt): What LiveGrid is, what a call is made of, and how to place your first one. 6 pages. - [Calls](https://app.livegrid.dev/docs/calls/llms.txt): Placing calls, granting access to them, and finding out what happened on them. 6 pages. - [Avatars](https://app.livegrid.dev/docs/avatars/llms.txt): Giving an agent a face: enrolment, consent, and the vendor that renders it. 4 pages. - [Deploy](https://app.livegrid.dev/docs/deploy/llms.txt): Standing up the media plane, the control plane and the API, and knowing they are healthy. 4 pages. - [Reference](https://app.livegrid.dev/docs/reference/llms.txt): Every endpoint, tool and command, with the request and response shapes they actually use. 8 pages. ## Every page ### Introduction #### Get started - [Overview](https://app.livegrid.dev/docs.md): Real-time voice and video on infrastructure you own. - [What LiveGrid is](https://app.livegrid.dev/docs/intro/about.md): A voice and video call stack you host yourself, and what that buys you. - [Your first call](https://app.livegrid.dev/docs/intro/quickstart.md): Mint a token, join a room, and put an agent on the other end of it. #### Understanding LiveGrid - [Control plane and media plane](https://app.livegrid.dev/docs/intro/architecture.md): Four processes, one of which touches audio. Which is which, and why they are apart. - [Rooms, participants and roles](https://app.livegrid.dev/docs/intro/rooms.md): The three nouns every call is made of, and the three roles a participant can hold. - [Regions](https://app.livegrid.dev/docs/intro/regions.md): One box per region, chosen by where the caller is. There is no cluster. ### Calls #### Placing a call - [Overview](https://app.livegrid.dev/docs/calls.md): The three call modes, and how to choose between them. - [Starting a call](https://app.livegrid.dev/docs/calls/start.md): One tool call opens a room, dispatches an agent, and hands back a token. - [Access tokens and grants](https://app.livegrid.dev/docs/calls/tokens.md): What a join token carries, how long it lives, and why callers never assemble their own. #### Knowing what happened - [Live state and history](https://app.livegrid.dev/docs/calls/live-vs-history.md): Two questions that look alike and have opposite failure modes. Do not mix them. - [Webhooks and events](https://app.livegrid.dev/docs/calls/webhooks.md): The media server reports the lifecycle. Verifying the signature is the whole gate. - [Transcripts and tool calls](https://app.livegrid.dev/docs/calls/transcripts.md): What the worker records from inside a conversation, and why it is best-effort. ### Avatars #### Avatars - [Overview](https://app.livegrid.dev/docs/avatars.md): What an avatar is here, and what it costs to put one on a call. - [Enrolling a face](https://app.livegrid.dev/docs/avatars/enrolment.md): A two-step upload, and why the bytes never pass through the API. - [Consent](https://app.livegrid.dev/docs/avatars/consent.md): A likeness is a person. Consent is a row that is queried on every call, not a checkbox. - [Providers and pricing](https://app.livegrid.dev/docs/avatars/providers.md): Ten vendors, their published per-minute prices, and what each caveat means. ### Deploy #### Running it - [Overview](https://app.livegrid.dev/docs/deploy.md): Four deployables, three platforms, and which of them ship on a push. - [The media plane](https://app.livegrid.dev/docs/deploy/media-plane.md): A rented box with a public address and an open UDP range, at about $7 a month. - [Environment](https://app.livegrid.dev/docs/deploy/environment.md): Every variable the kit reads, what it unlocks, and what happens when it is unset. - [Health and status](https://app.livegrid.dev/docs/deploy/health.md): Degraded is not down. What each health surface can and cannot tell you. ### Reference #### Get started - [Overview](https://app.livegrid.dev/docs/reference.md): Four callable surfaces, and which one you want. #### HTTP API - [Calls API](https://app.livegrid.dev/docs/reference/calls-api.md): Call history, headline statistics, one call in full, and live switchboard state. - [Avatars API](https://app.livegrid.dev/docs/reference/avatars-api.md): List, create, confirm, read and revoke an avatar. - [Webhook and ingest API](https://app.livegrid.dev/docs/reference/webhooks-api.md): The two endpoints other machines post to, and how each one authenticates. - [Control plane API](https://app.livegrid.dev/docs/reference/control-plane-api.md): Health, token minting and the avatar provider catalogue, on the Node service. #### Tools - [MCP tools](https://app.livegrid.dev/docs/reference/mcp.md): Seven tools, stateless, over JSON-RPC. The surface agents call. - [CLI (udk)](https://app.livegrid.dev/docs/reference/cli.md): Mint a token, list providers and probe the media plane from a terminal. - [Errors](https://app.livegrid.dev/docs/reference/errors.md): Every status this kit returns, what causes it, and what to do about it. --- 28 pages. Rendered at 2026-09-19T15:09:20.065Z.