get_playhead_info
Retrieve the current playhead position and playback status in Adobe Premiere Pro for automation, monitoring, or integration purposes.
Instructions
Get current playhead position and playback state
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- mcp-server.js:657-694 (handler)The main handler function that fetches playhead information from the local HTTP server at localhost:3001/api/playhead, processes the data, and returns formatted text response about playhead position, timecode, playback status, etc. Handles errors gracefully.
async getPlayheadInfo() { try { const response = await fetch('http://localhost:3001/api/playhead'); 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}`, }, ], }; } return { content: [ { type: 'text', text: `⏱️ **Playhead Info**\n\n**Sequence:** ${data.sequence_name}\n**Timecode:** ${data.timecode}\n**Frame:** ${data.frame_number}\n**Progress:** ${data.percentage_complete}%\n**Status:** ${data.is_playing ? '▶️ Playing' : '⏸️ Paused'}\n**Speed:** ${data.playback_speed}x`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `❌ **Failed to get playhead info**\n\nError: ${error.message}`, }, ], isError: true, }; } } - mcp-server.js:110-118 (schema)Tool definition in the listTools response, including name, description, and empty input schema (no parameters required).
{ name: "get_playhead_info", description: "Get current playhead position and playback state", inputSchema: { type: "object", properties: {}, required: [] } }, - mcp-server.js:246-247 (registration)Registration and dispatch in the tool call request handler switch statement, routing calls to the getPlayheadInfo handler method.
case 'get_playhead_info': return await this.getPlayheadInfo();