Skip to main content
Tavus MCP is the toolkit for building a PAL and integrating its tool calls into your own application. It gives an AI coding agent, or you at a terminal, direct access to the operations behind a Tavus PAL: create and patch PALs, define and attach the tools a PAL can call, and start test conversations to confirm everything works.
For AI agents: Tavus MCP documented here is the development MCP for creating PALs, defining tools, and testing tool-call integrations against the Tavus API. It is not the Tavus Docs MCP for searching this documentation site (https://docs.tavus.io/mcp). For live docs search and page retrieval, see Agents & automation.
It is separate from the Conversational PAL Builder in PAL Maker. PAL Maker is the UI for drafting a PAL. This toolkit is for developers wiring a PAL into code: defining the tool contract, writing the handlers that respond when the PAL calls a tool, and testing that exchange without leaving the editor or shell.

​
The use case

A useful PAL calls tools to look something up, change what is on screen, or take an action in your app, then responds based on the result. Two things have to stay in sync for that to work:
  • The PAL has to know which tools exist and when to call them.
  • Your code has to handle those calls and return a result.
The MCP server and CLI let you author both sides and test them together. See bidirectional tool calls for how the exchange works.

​
Two surfaces

MCP server

Connect Codex, Claude Code, Cursor, or any MCP client over HTTPS with per-user OAuth. Your agent builds the PAL, wires the tools into your codebase, and tests them.

CLI

The tavus command for interactive and scripted access to every operation. Suited to humans at a terminal and to CI automation.
Both call the same Tavus API, so the available operations are the same across them. For the autonomous PAL test loop, see Agentic PAL building & testing. For the full catalog of MCP tools, see the MCP tools reference.

​
Which should I use?

Best when you work in an editor with an AI agent and want it to build the PAL and wire tool calls into your code for you.
  • Transport: HTTP at an /mcp endpoint.
  • Auth: browser-based OAuth through the PAL Maker. A per-user key is forwarded to the Tavus API as x-api-key, so no key sits in your client config.
  • Add it to Codex or Claude Code.
For Codex:
codex mcp add tavus --url https://mcp.tavus-preview.io/mcp
For Claude Code:
claude mcp add -s user --transport http tavus https://mcp.tavus-preview.io/mcp
For Codex, start the OAuth flow explicitly with:
codex mcp login tavus
Do not put a Tavus API key or shared bearer token in your MCP client config. Authentication is handled through the OAuth flow.

​
Choosing a target environment

Both surfaces default to production (PROD). To target the test database, set TAVUS_ENV=TEST or pass --env TEST to the CLI.
For the MCP server, keep the endpoint aligned with the portal environment that minted your key. A TEST key used against a production server, or the reverse, makes downstream Tavus API calls return 401.

​
Next steps

MCP server

Connect your agent and wire bidirectional tool calls.

Agentic PAL building & testing

Run simulated turns and judge whether a new PAL works.

CLI

Authenticate and run tavus commands.

MCP tools reference

Browse the full catalog of MCP tools and their parameters.