Tavus MCP Server

Instructions

Implementation Reference

• src/index.ts:781-789 (handler)

  Handler function that executes the create_replica tool logic - makes a POST request to /replicas endpoint with the provided arguments and returns the response data as formatted JSON text

  private async createReplica(args: any) {
    const response = await this.axiosInstance.post('/replicas', args);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(response.data, null, 2),
      }],
    };
  }

• src/index.ts:135-173 (schema)

  Tool schema definition with name, description, and inputSchema specifying the structure and validation rules for create_replica tool inputs (train_video_url is required, plus optional replica_name, consent_video_url, callback_url, model_name, and properties)

  {
    name: 'create_replica',
    description: 'Create a new AI replica from a training video',
    inputSchema: {
      type: 'object',
      properties: {
        train_video_url: {
          type: 'string',
          description: 'Direct link to training video (S3, etc.)',
        },
        replica_name: {
          type: 'string',
          description: 'Name for the replica',
        },
        consent_video_url: {
          type: 'string',
          description: 'Optional separate consent video URL',
        },
        callback_url: {
          type: 'string',
          description: 'URL to receive training completion callback',
        },
        model_name: {
          type: 'string',
          description: 'Phoenix model version (phoenix-3 default)',
          enum: ['phoenix-2', 'phoenix-3'],
        },
        properties: {
          type: 'object',
          description: 'Additional replica properties',
          properties: {
            gaze_correction: { type: 'boolean' },
            background_green_screen: { type: 'boolean' },
          },
        },
      },
      required: ['train_video_url'],
    },
  },

• src/index.ts:692-693 (registration)

  Registration/routing logic in CallToolRequestSchema handler that maps the 'create_replica' tool name to its handler method

  case 'create_replica':
    return await this.createReplica(request.params.arguments);