How to add a logo watermark to a video with Medux MCP
Learn to add a logo watermark to a video with the Medux API through Codex or Claude MCP. Check inputs, tool calls, task status, and output.
Follow the Codex or Claude workflow
The Medux operation and request fields are shared. Switch tabs for the client-specific prompt, approval pattern, screenshots, and walkthrough.
Codex-specific workflow
Run Add a Logo Watermark to Video as a Codex MCP task
Use the active workspace as the source of truth. Ask Codex to identify the source video, logo image, placement, scale, and opacity, select the Medux video watermark tool, and keep the Medux task ID and returned output with the rest of the project. Naming the input roles and the expected result prevents an agent from guessing which file should be used where.
Codex prompt pattern
In this workspace, use the Medux video watermark tool through Medux MCP to add a logo watermark to a video.
First inspect and identify the source video, logo image, placement, scale, and opacity.
Show me the exact tool arguments before execution.
After the task completes, return the branded MP4 and verify that the logo position, size, opacity, duration, and video playback are correct.Approval gate
Before approving the call, compare the selected tool, file or asset IDs, ordering, timing, and output settings with the request. If a local filename was mapped to an uploaded Medux file ID, keep that mapping visible so it can be audited later.
Result verification
Let Codex monitor an asynchronous task until it reaches a terminal state, then save or report the branded MP4. The final check is explicit: confirm that the logo position, size, opacity, duration, and video playback are correct.
Before you start
Prepare two files in the Codex workspace: the source video and the logo image. In the recorded workflow, the video is sample.mp4 and the logo is logo2.png.
Step-by-step workflow
Ask Codex to add the logo watermark
Start with a simple instruction. The key is to name both assets and describe the placement clearly.
Use Medux to add logo2.png to sample.mp4. Resize the logo to an appropriate size and place it in the top-right corner of the video.
logo2.png to sample.mp4 and place it in the top-right corner.Let Codex inspect the project files
Codex checks the workspace before calling Medux. It confirms the video file, the logo file, and a prior output frame that helps estimate the watermark size and placement.
Find the Medux add-logo workflow
Next, Codex identifies the Medux workflow for adding a logo to video. The important parameters are the logo position, width, and height.
{
"tool": "add_logo_to_video",
"video": "sample.mp4",
"logo": "logo2.png",
"placement": {
"corner": "top-right",
"logo_width": 180,
"logo_height": 180,
"margin_x": 24,
"margin_y": 24
}
}
Upload assets and submit the Medux task
Codex prepares upload targets for the MP4 and PNG, then submits the Medux task. In the example, it chooses a 180×180 logo with a 24px top-right margin for a 1920×1080 source video.
POST /api/app/v1/process/video/add_logo_to_video
{
"video_url": "<uploaded-sample-mp4-url>",
"logo_url": "<uploaded-logo2-png-url>",
"x": 1716,
"y": 24,
"logo_width": 180,
"logo_height": 180
}
Approve the download when needed
If the environment asks for confirmation before downloading the Medux result, approve the command so Codex can save the completed video into the workspace.
Verify the final MP4
Codex saves the final file, extracts a preview frame, and confirms that the logo is visible in the top-right corner without dominating the video.
sample_logo2_top_right.mp4 plus a preview frame for quick visual verification.Publishing checklist
Use this workflow as a short product tutorial for your website, docs, YouTube description, or social post. Keep the story focused: one prompt, one MCP connection, one finished video.
Name the video and logo files directly.
Specify corner, size, and margin.
Always verify a frame before publishing.
Example result
src / logo / rst demonstration
Below is the complete watermark example: src is the original video, logo is the image added as a watermark, and rst is the final branded video generated by Medux.
Explore related workflows
Continue with a nearby Medux workflow or compare how the same task works across Claude MCP and Codex MCP.
Claude-specific workflow
Run Add a Logo Watermark to Video as a Claude MCP workflow
Keep the goal, source assets, and constraints together in the conversation. Ask Claude to restate the source video, logo image, placement, scale, and opacity before proposing the Medux video watermark tool. That context checkpoint makes the file roles and desired outcome easy to correct before any Medux call is approved.
Claude prompt pattern
Using the assets and requirements in this conversation, help me add a logo watermark to a video with Medux MCP.
Restate which input fulfills each role: the source video, logo image, placement, scale, and opacity.
Propose the the Medux video watermark tool call and summarize its arguments before asking for approval.
When it finishes, return the branded MP4 with a checklist confirming that the logo position, size, opacity, duration, and video playback are correct.Context checkpoint
Have Claude summarize the intended transformation, identify every source asset by role, and list the important constraints. Review that summary together with the proposed tool arguments; correct the conversation first if a file, order, time range, or setting is ambiguous.
Result verification
Keep the Medux task ID in the conversation while Claude checks progress. When processing ends, ask for the branded MP4 plus a concise validation checklist confirming that the logo position, size, opacity, duration, and video playback are correct.
Prepare two local files
sample.mp4logo.png, ideally with transparencymedux connector available in Claude's context panel.Core workflow
Describe the result in one prompt
Tell Claude which files to use, where the watermark should appear, and how uploads should be handled. In the demonstrated workflow, the logo is placed in the top-right corner.
Prompt used in Claude
Use Medux to add logo.png to sample.mp4.
Resize the logo to an appropriate size and place it
in the top-right corner of the video.
Upload the files using the curl command.The code block uses wrapping rules such as white-space: pre-wrap, overflow-wrap: anywhere, and word-break: break-word, so long commands stay inside the page on desktop and mobile.
Let Claude inspect the media and choose overlay settings
Claude checks the video and logo dimensions, then calculates a practical watermark size and position. In the example, the 1920×1080 video receives a 150×150 logo near the top-right edge with padding.
Video: 1920 × 1080
Logo target: 150 × 150
Position: x = 1750, y = 20
Placement: top-right with padding
Upload the video and logo to Medux
Claude calls Medux to obtain upload destinations and sends both files with curl. Successful uploads return an HTTP 200 response and file identifiers that the processing task can reference.
curl --request PUT --header "Content-Type: video/mp4" --upload-file "sample.mp4" "<MEDUX_SIGNED_UPLOAD_URL>"
curl --request PUT --header "Content-Type: image/png" --upload-file "logo.png" "<MEDUX_SIGNED_UPLOAD_URL>"
Run the Medux watermark task
After both uploads are available, Claude sends the video file, logo file, target size, and placement values to the Medux processing tool. Medux creates an asynchronous media task and returns a task identifier.
Input video: sample.mp4
Overlay image: logo.png
Logo width: 150
Logo height: 150
X position: 1750
Y position: 20
Output format: MP4
Wait for completion and retrieve the output
Claude checks the task status until processing is complete. Once Medux returns the result URL, Claude can download the finished MP4 into the local workspace.
curl --location "<MEDUX_RESULT_URL>" --output "sample_with_logo_topright.mp4"
Result
The final video keeps its original scene and motion while displaying a clean, consistently positioned logo watermark in the top-right corner.
Reusable prompt template
Replace the file names and placement instructions to reuse the same workflow for other videos.
Use Medux to add <logo-file> to <video-file>.
Resize the logo to <size or "an appropriate size">.
Place it in the <top-right / top-left / bottom-right / bottom-left>
corner with comfortable padding.
Upload the local files using curl, run the Medux task,
and save the finished MP4 in the current workspace.Example result
src / logo / rst demonstration
Below is the complete logo-watermark example: src is the original video, logo is the image added as the watermark, and rst is the final video generated by Medux.
Explore related workflows
Continue with a nearby Medux workflow or compare how the same task works across Claude MCP and Codex MCP.