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.
Get started with Tavus
- Add Tavus to your Weavz workspace and connect the account you want to use.
- Review the available tools below and enable the actions your task needs. Check the account permissions before allowing changes.
- Connect a compatible AI client to your workspace, or use the actions API from your application.
Tools
| Name | Description |
|---|---|
Generate Video generate_videoGenerate an async Tavus video using a face and either a script or an audio URL. | Generate an async Tavus video using a face and either a script or an audio URL. |
List Videos list_videosList Tavus generated videos with pagination. | List Tavus generated videos with pagination. |
Get Video get_videoGet status, download URLs, and metadata for a Tavus generated video. | Get status, download URLs, and metadata for a Tavus generated video. |
Rename Video rename_videoRename a Tavus generated video. | Rename a Tavus generated video. |
Delete Video delete_videoDelete a Tavus video. Enable hard delete only when you intend Tavus to remove associated media assets irrevocably. | Delete a Tavus video. Enable hard delete only when you intend Tavus to remove associated media assets irrevocably. |
Create Face create_faceCreate a Tavus Phoenix face from a training video URL or image URL. | Create a Tavus Phoenix face from a training video URL or image URL. |
List Faces list_facesList Tavus faces created by the authenticated account. | List Tavus faces created by the authenticated account. |
Get Face get_faceGet a Tavus face by ID. | Get a Tavus face by ID. |
Rename Face rename_faceRename a Tavus face. | Rename a Tavus face. |
Delete Face delete_faceDelete a Tavus face. Enable hard delete only when you intend Tavus to remove associated training footage irrevocably. | Delete a Tavus face. Enable hard delete only when you intend Tavus to remove associated training footage irrevocably. |
List Voices list_voicesList Tavus stock voice_name values and linked face metadata. | List Tavus stock voice_name values and linked face metadata. |
Create Conversation create_conversationStart a real-time Tavus CVI conversation with a face or PAL. | Start a real-time Tavus CVI conversation with a face or PAL. |
List Conversations list_conversationsList Tavus conversations. | List Tavus conversations. |
Get Conversation get_conversationGet a Tavus conversation by ID, optionally with verbose event data through query params. | Get a Tavus conversation by ID, optionally with verbose event data through query params. |
End Conversation end_conversationEnd an active Tavus conversation without deleting its data. | End an active Tavus conversation without deleting its data. |
Delete Conversation delete_conversationDelete a Tavus conversation. Use End Conversation for normal call cleanup; hard delete removes associated assets. | Delete a Tavus conversation. Use End Conversation for normal call cleanup; hard delete removes associated assets. |
Record Canvas Interaction record_canvas_interactionRecord a Magic Canvas interaction while a Tavus conversation is active. | Record a Magic Canvas interaction while a Tavus conversation is active. |
List Canvas Interactions list_canvas_interactionsList Magic Canvas interactions for a Tavus conversation. | List Magic Canvas interactions for a Tavus conversation. |
Create Deployment create_deploymentCreate a managed Tavus deployment for widget, embed, or landing-page channels. | Create a managed Tavus deployment for widget, embed, or landing-page channels. |
List Deployments list_deploymentsList Tavus deployments. | List Tavus deployments. |
Get Deployment get_deploymentGet a Tavus deployment by ID. | Get a Tavus deployment by ID. |
Patch Deployment patch_deploymentPatch a Tavus deployment using JSON Patch operations. | Patch a Tavus deployment using JSON Patch operations. |
Delete Deployment delete_deploymentDelete a Tavus deployment. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus deployment. This is destructive when Tavus marks the resource as hard-deleted. |
Get Deployment Init Config get_deployment_init_configGet the public initialization config for a Tavus deployment. | Get the public initialization config for a Tavus deployment. |
Start Deployment Conversation start_deployment_conversationStart a conversation from a Tavus deployment. | Start a conversation from a Tavus deployment. |
End Deployment Conversation end_deployment_conversationEnd a conversation started through a Tavus deployment. | End a conversation started through a Tavus deployment. |
Create PAL create_palCreate a Tavus PAL with system prompt, pipeline mode, default face, layers, tools, and knowledge configuration. | Create a Tavus PAL with system prompt, pipeline mode, default face, layers, tools, and knowledge configuration. |
List PALs list_palsList Tavus PALs. | List Tavus PALs. |
Get PAL get_palGet a Tavus PAL by ID. | Get a Tavus PAL by ID. |
Patch PAL patch_palPatch a Tavus PAL using JSON Patch operations. | Patch a Tavus PAL using JSON Patch operations. |
Delete PAL delete_palDelete a Tavus PAL. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus PAL. This is destructive when Tavus marks the resource as hard-deleted. |
Check Conferencing Username check_conferencing_usernameCheck whether a tavusinvite.com conferencing username is available before creating or patching a PAL. | Check whether a tavusinvite.com conferencing username is available before creating or patching a PAL. |
Create Tool create_toolCreate a standalone Tavus tool for PAL LLM/perception/post-call use. | Create a standalone Tavus tool for PAL LLM/perception/post-call use. |
List Tools list_toolsList Tavus tools, including user-owned tools and optionally built-in system tools. | List Tavus tools, including user-owned tools and optionally built-in system tools. |
Get Tool get_toolGet a Tavus tool by ID. Tavus redacts secret fields in responses. | Get a Tavus tool by ID. Tavus redacts secret fields in responses. |
Update Tool update_toolUpdate mutable fields on a Tavus tool. | Update mutable fields on a Tavus tool. |
Delete Tool delete_toolDelete a Tavus tool. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus tool. This is destructive when Tavus marks the resource as hard-deleted. |
Attach Tools To PAL attach_tools_to_palAttach one or more standalone Tavus tools to a PAL. | Attach one or more standalone Tavus tools to a PAL. |
List PAL Tools list_pal_toolsList standalone tools currently attached to a Tavus PAL. | List standalone tools currently attached to a Tavus PAL. |
Detach Tool From PAL detach_tool_from_palDetach a standalone tool from a Tavus PAL without deleting the tool. | Detach a standalone tool from a Tavus PAL without deleting the tool. |
List Skills list_skillsList Tavus pre-built skills that can be attached to PALs. | List Tavus pre-built skills that can be attached to PALs. |
Get Skill get_skillGet Tavus skill registry metadata by ID. | Get Tavus skill registry metadata by ID. |
List PAL Skills list_pal_skillsList skills attached to a Tavus PAL. | List skills attached to a Tavus PAL. |
Replace PAL Skills replace_pal_skillsReplace the full skill set on a Tavus PAL. Skills absent from the body are detached. | Replace the full skill set on a Tavus PAL. Skills absent from the body are detached. |
Attach Skill To PAL attach_skill_to_palAttach or overwrite a Tavus skill configuration on a PAL. | Attach or overwrite a Tavus skill configuration on a PAL. |
Update PAL Skill update_pal_skillMerge changes into an attached Tavus PAL skill configuration. | Merge changes into an attached Tavus PAL skill configuration. |
Detach Skill From PAL detach_skill_from_palDetach a Tavus skill from a PAL. | Detach a Tavus skill from a PAL. |
Create Document create_documentCreate a Tavus knowledge-base document from the documented JSON body. | Create a Tavus knowledge-base document from the documented JSON body. |
List Documents list_documentsList Tavus knowledge-base documents. | List Tavus knowledge-base documents. |
Get Document get_documentGet a Tavus document by ID. | Get a Tavus document by ID. |
Update Document update_documentUpdate a Tavus document name, tags, or other documented mutable fields. | Update a Tavus document name, tags, or other documented mutable fields. |
Delete Document delete_documentDelete a Tavus document. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus document. This is destructive when Tavus marks the resource as hard-deleted. |
Recrawl Document recrawl_documentTrigger a recrawl for a Tavus website document. | Trigger a recrawl for a Tavus website document. |
Create Guardrails create_guardrailsCreate Tavus guardrails for PAL behavior boundaries. | Create Tavus guardrails for PAL behavior boundaries. |
List Guardrails list_guardrailsList Tavus guardrails. Pass legacy=false in query for new integrations. | List Tavus guardrails. Pass legacy=false in query for new integrations. |
Get Guardrails get_guardrailsGet Tavus guardrails by ID. | Get Tavus guardrails by ID. |
Patch Guardrails patch_guardrailsPatch Tavus guardrails using JSON Patch operations. | Patch Tavus guardrails using JSON Patch operations. |
Delete Guardrails delete_guardrailsDelete a Tavus guardrails. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus guardrails. This is destructive when Tavus marks the resource as hard-deleted. |
Create Objective create_objectiveCreate Tavus objectives for PAL goals and scoring. | Create Tavus objectives for PAL goals and scoring. |
List Objectives list_objectivesList Tavus objectives. | List Tavus objectives. |
Get Objective get_objectiveGet a Tavus objective by ID. | Get a Tavus objective by ID. |
Patch Objective patch_objectivePatch a Tavus objective using JSON Patch operations. | Patch a Tavus objective using JSON Patch operations. |
Delete Objective delete_objectiveDelete a Tavus objective. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus objective. This is destructive when Tavus marks the resource as hard-deleted. |
Create Pronunciation Dictionary create_pronunciation_dictionaryCreate a Tavus pronunciation dictionary with custom spoken rules. | Create a Tavus pronunciation dictionary with custom spoken rules. |
List Pronunciation Dictionaries list_pronunciation_dictionariesList Tavus pronunciation dictionaries with pagination. | List Tavus pronunciation dictionaries with pagination. |
Get Pronunciation Dictionary get_pronunciation_dictionaryGet a Tavus pronunciation dictionary by ID. | Get a Tavus pronunciation dictionary by ID. |
Update Pronunciation Dictionary update_pronunciation_dictionaryUpdate a Tavus pronunciation dictionary using JSON Patch operations. | Update a Tavus pronunciation dictionary using JSON Patch operations. |
Delete Pronunciation Dictionary delete_pronunciation_dictionaryDelete a Tavus pronunciation dictionary. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus pronunciation dictionary. This is destructive when Tavus marks the resource as hard-deleted. |
Create Transcription create_transcriptionCreate a Tavus transcription job for a public or presigned media file URL. | Create a Tavus transcription job for a public or presigned media file URL. |
List Transcriptions list_transcriptionsList Tavus transcriptions with pagination. | List Tavus transcriptions with pagination. |
Get Transcription get_transcriptionGet a Tavus transcription by ID. Transcript text can contain sensitive conversation or media contents. | Get a Tavus transcription by ID. Transcript text can contain sensitive conversation or media contents. |
Delete Transcription delete_transcriptionDelete a Tavus transcription. This is destructive when Tavus marks the resource as hard-deleted. | Delete a Tavus transcription. This is destructive when Tavus marks the resource as hard-deleted. |
Custom API Call custom_api_callMake a custom Tavus API call. Non-GET calls require confirmation. | Make a custom Tavus API call. Non-GET calls require confirmation. |
Triggers
| Name | Description |
|---|---|
Video Status Changed video_status_changedTriggers when a specific Tavus generated video status changes. | Triggers when a specific Tavus generated video status changes. |
Video Ready video_readyTriggers when a specific Tavus generated video reaches ready. | Triggers when a specific Tavus generated video reaches ready. |
Video Failed video_failedTriggers when a specific Tavus generated video reaches error. | Triggers when a specific Tavus generated video reaches error. |
Face Status Changed face_status_changedTriggers when a specific Tavus face status changes. | Triggers when a specific Tavus face status changes. |
Face Ready face_readyTriggers when a specific Tavus face reaches ready. | Triggers when a specific Tavus face reaches ready. |
Face Failed face_failedTriggers when a specific Tavus face reaches error. | Triggers when a specific Tavus face reaches error. |
Conversation Status Changed conversation_status_changedTriggers when a specific Tavus conversation status changes. | Triggers when a specific Tavus conversation status changes. |
Conversation Ended conversation_endedTriggers when a specific Tavus conversation ends. | Triggers when a specific Tavus conversation ends. |
Quick Start
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.