Premiere Pro MCP Server

Instructions

Implementation Reference

• mcp-server.js:907-968 (handler)

  The handler function that implements the export_project tool logic by making a POST request to the local API endpoint to queue or start the export process.

  async exportProject(args) {
    const { output_path, preset_name = "H.264 High Quality", include_audio = true } = args;
    
    try {
      const response = await fetch('http://localhost:3001/api/export-project', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
        },
        body: JSON.stringify({
          output_path,
          preset_name,
          include_audio
        }),
      });
      
      if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
      
      const data = await response.json();
      
      if (data.error) {
        return {
          content: [
            {
              type: 'text',
              text: `⚠️  ${data.error}`,
            },
          ],
        };
      }
  
      if (data.status === 'queued') {
        return {
          content: [
            {
              type: 'text',
              text: `🎬 **Export Queued Successfully**\n\n**Output Path:** ${data.output_path}\n**Preset:** ${data.preset_name}\n**Sequence:** ${data.sequence_name}\n**Queue Position:** ${data.queue_position}\n**Estimated Duration:** ${data.estimated_duration}`,
            },
          ],
        };
      } else {
        return {
          content: [
            {
              type: 'text',
              text: `✅ **Export Started Successfully**\n\n**Output Path:** ${data.output_path}\n**Preset:** ${data.preset_name}\n**Sequence:** ${data.sequence_name}\n**Status:** ${data.status}`,
            },
          ],
        };
      }
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ **Failed to export project**\n\nError: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

• mcp-server.js:187-208 (schema)

  The tool schema defining the name, description, input parameters, and validation for the export_project tool.

  {
    name: 'export_project',
    description: 'Export the current project or sequence',
    inputSchema: {
      type: 'object',
      properties: {
        output_path: {
          type: 'string',
          description: 'Output file path',
        },
        preset_name: {
          type: 'string',
          description: 'Export preset name (default: H.264 High Quality)',
        },
        include_audio: {
          type: 'boolean',
          description: 'Include audio in export (default: true)',
        },
      },
      required: ['output_path'],
    },
  },

• mcp-server.js:261-262 (registration)

  The dispatch/registration in the switch statement that routes calls to the export_project handler.

  case 'export_project':
    return await this.exportProject(args);