get_timeline_clips
Retrieve detailed information about all clips in the active Premiere Pro timeline to streamline project analysis, automation, and integration workflows.
Instructions
Get all clips in the active sequence with detailed information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- mcp-server.js:83-91 (schema)Tool schema definition including name, description, and empty input schema (no required parameters). This is returned in the ListTools response.{ name: "get_timeline_clips", description: "Get all clips in the active sequence with detailed information", inputSchema: { type: "object", properties: {}, required: [] } },
- mcp-server.js:237-238 (registration)Dispatcher in the CallToolRequestSchema handler that routes calls to the getTimelineClips method.case 'get_timeline_clips': return await this.getTimelineClips();
- mcp-server.js:526-567 (handler)Main handler function that executes the tool: fetches clip data from localhost:3001/api/timeline-clips, processes up to 20 clips, formats a markdown response with clip details, handles errors.async getTimelineClips() { try { const response = await fetch('http://localhost:3001/api/timeline-clips'); 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}`, }, ], }; } const clipsList = data.clips.slice(0, 20).map(clip => `• **${clip.clip_name}** (${clip.track_type}${clip.track_number})\n 📍 ${clip.timeline_in} → ${clip.timeline_out} (${clip.duration})\n 📁 ${clip.source_file_path.split('\\').pop()}\n ⚡ ${clip.speed}% ${clip.effects.length > 0 ? `| Effects: ${clip.effects.join(', ')}` : ''}` ).join('\n\n'); return { content: [ { type: 'text', text: `🎬 **Timeline Clips (${data.total_clips} total${data.total_clips > 20 ? ', showing first 20' : ''})**\n\n${clipsList}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `❌ **Failed to get timeline clips**\n\nError: ${error.message}`, }, ], isError: true, }; } }