add_text_overlay
Adds a text layer (title) over the video timeline. Requires a MOGRT (.mogrt) template file path. Supports up to 4 text fields (text, text2, text3, text4) — each populates the Nth "AE.ADBE Text" component in the MOGRT (e.g., for Basic Lower Third: text=main title, text2=subtitle).
This record as markdown: /tools/adobe-premiere-pro-mcp/add-text-overlay.md
What add_text_overlay does on Adobe Premiere Pro
AI agents use add_text_overlay to create or update resources in Adobe Premiere Pro, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Adobe Premiere Pro environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
text | string | Yes | Text for the first AE text component in the MOGRT (typically the main title) |
text2 | string | — | Text for the second AE text component (e.g., subtitle of a lower third) |
text3 | string | — | Text for the third AE text component (if present) |
text4 | string | — | Text for the fourth AE text component (if present) |
duration | number | Yes | How long the text should remain on screen in seconds (best-effort; the MOGRT's natural duration may take precedence) |
mogrtPath | string | — | Absolute path to a .mogrt template file (required for text overlays) |
startTime | number | Yes | The time in seconds when the text should appear |
sequenceId | string | Yes | The sequence to add the text to |
trackIndex | number | Yes | The video track to place the text on (0-indexed; create the track first via add_track if needed) |
textPropertyName | string | — | Override: explicit displayName of the property to write into. When set, only `text` is written (text2/text3/text4 are ignored) and the call fails if no property |
rollbackOnTextFailure | boolean | — | If true, remove the imported timeline Graphic when every requested text write fails. Defaults to false; the imported project item may remain in the Project pane |
Parameters from the server's own tool schema.
Why add_text_overlay is rated Medium
An AI agent can call add_text_overlay faster than any human can review: one bad instruction and it creates or modifies resources in Adobe Premiere Pro by the hundred, each call as confident as the last.
Risk signalsHigh parameter count (11 properties)
Attacks that exploit this kind of access
The rule that runs add_text_overlay safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Adobe Premiere Pro, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For add_text_overlay, this is the rule to start with:
add_text_overlay stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Adobe Premiere Pro, apply this rule, and every add_text_overlay call is checked against it from then on.
Questions about add_text_overlay
Adds a text layer (title) over the video timeline. Requires a MOGRT (.mogrt) template file path. Supports up to 4 text fields (text, text2, text3, text4) — each populates the Nth "AE.ADBE Text" component in the MOGRT (e.g., for Basic Lower Third: text=main title, text2=subtitle). It is categorised as a Write tool in the Adobe Premiere Pro MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
add_text_overlay accepts 11 parameters: text, text2, text3, text4, duration, mogrtPath, startTime, sequenceId, trackIndex, textPropertyName, rollbackOnTextFailure. Required: text, duration, startTime, sequenceId, trackIndex. The full parameter table on this page comes from the server's own tool schema.
Register the Adobe Premiere Pro MCP server in PolicyLayer and add a rule for add_text_overlay: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Adobe Premiere Pro. Nothing to install.
add_text_overlay is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the add_text_overlay rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for add_text_overlay. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
add_text_overlay is provided by the Adobe Premiere Pro MCP server (adobe-premiere-pro-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Adobe Premiere Pro, and thousands of servers like it.
This server
Across the catalogue