Skip to content
Weavz
Menu
Tavus

Tavus MCP integration

Create Tavus AI faces, videos, PALs, conversations, deployments, tools, documents, guardrails, objectives, transcriptions, and lifecycle polling triggers.

Sign in, add Tavus in Apps, then choose the account your AI can use.

73 tools
8 triggers
Use withChatGPTClaudeClaude CodeCursorCodexMCP clientsSetup guide

Get started with Tavus

  1. Add Tavus to your Weavz workspace and connect the account you want to use.
  2. Review the available tools below and enable the actions your task needs. Check the account permissions before allowing changes.
  3. Connect a compatible AI client to your workspace, or use the actions API from your application.

Tools

Name

Generate Video

generate_video

Generate an async Tavus video using a face and either a script or an audio URL.

List Videos

list_videos

List Tavus generated videos with pagination.

Get Video

get_video

Get status, download URLs, and metadata for a Tavus generated video.

Rename Video

rename_video

Rename a Tavus generated video.

Delete Video

delete_video

Delete a Tavus video. Enable hard delete only when you intend Tavus to remove associated media assets irrevocably.

Create Face

create_face

Create a Tavus Phoenix face from a training video URL or image URL.

List Faces

list_faces

List Tavus faces created by the authenticated account.

Get Face

get_face

Get a Tavus face by ID.

Rename Face

rename_face

Rename a Tavus face.

Delete Face

delete_face

Delete a Tavus face. Enable hard delete only when you intend Tavus to remove associated training footage irrevocably.

List Voices

list_voices

List Tavus stock voice_name values and linked face metadata.

Create Conversation

create_conversation

Start a real-time Tavus CVI conversation with a face or PAL.

List Conversations

list_conversations

List Tavus conversations.

Get Conversation

get_conversation

Get a Tavus conversation by ID, optionally with verbose event data through query params.

End Conversation

end_conversation

End an active Tavus conversation without deleting its data.

Delete Conversation

delete_conversation

Delete a Tavus conversation. Use End Conversation for normal call cleanup; hard delete removes associated assets.

Record Canvas Interaction

record_canvas_interaction

Record a Magic Canvas interaction while a Tavus conversation is active.

List Canvas Interactions

list_canvas_interactions

List Magic Canvas interactions for a Tavus conversation.

Create Deployment

create_deployment

Create a managed Tavus deployment for widget, embed, or landing-page channels.

List Deployments

list_deployments

List Tavus deployments.

Get Deployment

get_deployment

Get a Tavus deployment by ID.

Patch Deployment

patch_deployment

Patch a Tavus deployment using JSON Patch operations.

Delete Deployment

delete_deployment

Delete a Tavus deployment. This is destructive when Tavus marks the resource as hard-deleted.

Get Deployment Init Config

get_deployment_init_config

Get the public initialization config for a Tavus deployment.

Start Deployment Conversation

start_deployment_conversation

Start a conversation from a Tavus deployment.

End Deployment Conversation

end_deployment_conversation

End a conversation started through a Tavus deployment.

Create PAL

create_pal

Create a Tavus PAL with system prompt, pipeline mode, default face, layers, tools, and knowledge configuration.

List PALs

list_pals

List Tavus PALs.

Get PAL

get_pal

Get a Tavus PAL by ID.

Patch PAL

patch_pal

Patch a Tavus PAL using JSON Patch operations.

Delete PAL

delete_pal

Delete a Tavus PAL. This is destructive when Tavus marks the resource as hard-deleted.

Check Conferencing Username

check_conferencing_username

Check whether a tavusinvite.com conferencing username is available before creating or patching a PAL.

Create Tool

create_tool

Create a standalone Tavus tool for PAL LLM/perception/post-call use.

List Tools

list_tools

List Tavus tools, including user-owned tools and optionally built-in system tools.

Get Tool

get_tool

Get a Tavus tool by ID. Tavus redacts secret fields in responses.

Update Tool

update_tool

Update mutable fields on a Tavus tool.

Delete Tool

delete_tool

Delete a Tavus tool. This is destructive when Tavus marks the resource as hard-deleted.

Attach Tools To PAL

attach_tools_to_pal

Attach one or more standalone Tavus tools to a PAL.

List PAL Tools

list_pal_tools

List standalone tools currently attached to a Tavus PAL.

Detach Tool From PAL

detach_tool_from_pal

Detach a standalone tool from a Tavus PAL without deleting the tool.

List Skills

list_skills

List Tavus pre-built skills that can be attached to PALs.

Get Skill

get_skill

Get Tavus skill registry metadata by ID.

List PAL Skills

list_pal_skills

List skills attached to a Tavus PAL.

Replace PAL Skills

replace_pal_skills

Replace the full skill set on a Tavus PAL. Skills absent from the body are detached.

Attach Skill To PAL

attach_skill_to_pal

Attach or overwrite a Tavus skill configuration on a PAL.

Update PAL Skill

update_pal_skill

Merge changes into an attached Tavus PAL skill configuration.

Detach Skill From PAL

detach_skill_from_pal

Detach a Tavus skill from a PAL.

Create Document

create_document

Create a Tavus knowledge-base document from the documented JSON body.

List Documents

list_documents

List Tavus knowledge-base documents.

Get Document

get_document

Get a Tavus document by ID.

Update Document

update_document

Update a Tavus document name, tags, or other documented mutable fields.

Delete Document

delete_document

Delete a Tavus document. This is destructive when Tavus marks the resource as hard-deleted.

Recrawl Document

recrawl_document

Trigger a recrawl for a Tavus website document.

Create Guardrails

create_guardrails

Create Tavus guardrails for PAL behavior boundaries.

List Guardrails

list_guardrails

List Tavus guardrails. Pass legacy=false in query for new integrations.

Get Guardrails

get_guardrails

Get Tavus guardrails by ID.

Patch Guardrails

patch_guardrails

Patch Tavus guardrails using JSON Patch operations.

Delete Guardrails

delete_guardrails

Delete a Tavus guardrails. This is destructive when Tavus marks the resource as hard-deleted.

Create Objective

create_objective

Create Tavus objectives for PAL goals and scoring.

List Objectives

list_objectives

List Tavus objectives.

Get Objective

get_objective

Get a Tavus objective by ID.

Patch Objective

patch_objective

Patch a Tavus objective using JSON Patch operations.

Delete Objective

delete_objective

Delete a Tavus objective. This is destructive when Tavus marks the resource as hard-deleted.

Create Pronunciation Dictionary

create_pronunciation_dictionary

Create a Tavus pronunciation dictionary with custom spoken rules.

List Pronunciation Dictionaries

list_pronunciation_dictionaries

List Tavus pronunciation dictionaries with pagination.

Get Pronunciation Dictionary

get_pronunciation_dictionary

Get a Tavus pronunciation dictionary by ID.

Update Pronunciation Dictionary

update_pronunciation_dictionary

Update a Tavus pronunciation dictionary using JSON Patch operations.

Delete Pronunciation Dictionary

delete_pronunciation_dictionary

Delete a Tavus pronunciation dictionary. This is destructive when Tavus marks the resource as hard-deleted.

Create Transcription

create_transcription

Create a Tavus transcription job for a public or presigned media file URL.

List Transcriptions

list_transcriptions

List Tavus transcriptions with pagination.

Get Transcription

get_transcription

Get a Tavus transcription by ID. Transcript text can contain sensitive conversation or media contents.

Delete Transcription

delete_transcription

Delete a Tavus transcription. This is destructive when Tavus marks the resource as hard-deleted.

Custom API Call

custom_api_call

Make a custom Tavus API call. Non-GET calls require confirmation.

Triggers

Name

Video Status Changed

video_status_changed

Triggers when a specific Tavus generated video status changes.

Video Ready

video_ready

Triggers when a specific Tavus generated video reaches ready.

Video Failed

video_failed

Triggers when a specific Tavus generated video reaches error.

Face Status Changed

face_status_changed

Triggers when a specific Tavus face status changes.

Face Ready

face_ready

Triggers when a specific Tavus face reaches ready.

Face Failed

face_failed

Triggers when a specific Tavus face reaches error.

Conversation Status Changed

conversation_status_changed

Triggers when a specific Tavus conversation status changes.

Conversation Ended

conversation_ended

Triggers when a specific Tavus conversation ends.

Quick Start

TypeScript
import { WeavzClient } from '@weavz-io/sdk'

const weavz = new WeavzClient({ apiKey: 'wvz_...' })

const result = await weavz.actions.execute('tavus', 'generate_video', {
  workspaceId: '550e8400-e29b-41d4-a716-446655440000',
  integrationAlias: 'tavus',
  input: { /* ... */ },
})

Related Integrations

Explore integrations in other categories

Frequently Asked Questions

Is there a Tavus MCP server through Weavz?

Yes. Add the Tavus integration to a Weavz workspace, enable the actions you need and connect any required account. Weavz provides the workspace MCP endpoint in Tool Mode or Code Mode. The catalog currently lists 73 Tavus actions.

What can an AI agent do with Tavus?

Available actions include Generate Video, List Videos, Get Video, Rename Video, Delete Video, and more. Your workspace exposes only the actions you enable. The agent also needs the intended account access and any required input values.

How do I connect Tavus to Claude or ChatGPT?

Use a compatible remote MCP client, add the Weavz connector and choose a workspace. Add Tavus, connect the required account and review the enabled actions. Client availability and account requirements vary; adding the connector does not authorize every app automatically.

Can I use Tavus through an API or SDK?

Yes, supported actions can run through the Weavz REST API, TypeScript SDK or Python SDK. Configure a workspace and the required connections, use scoped access, and pass the intended end-user context when acting for a customer.

What authentication does Tavus require?

The catalog lists an API key for Tavus. Use Hosted Connect to authorize the intended account. Required permissions, provider app access and available connection methods depend on the integration.

How do I review sensitive Tavus actions?

Limit enabled actions, scope credentials to the intended user and configure Human Gates for the operations that need review. A matching policy can pause a send, record change or other sensitive action for an approver before execution.

What limits or costs apply to Tavus?

Weavz plan limits apply to the actions and resources you use. The external provider may also require an account, a paid plan, API credits or specific permissions, and may enforce its own rate limits. Check current Weavz pricing and the provider’s terms before rollout.

What Tavus triggers are available?

The catalog lists 8 triggers, including Video Status Changed, Video Ready, Video Failed, Face Status Changed, Face Ready, and more. Configure the trigger and your event handler before using incoming events to start work.

Connect Tavus in minutes

Get 20,000 free action executions every month. No credit card required.