Submagic (BYOK) — connector documentation

MCP endpoint: https://byok-submagic.connectorbay.com/mcp
REST API: POST https://byok-submagic.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-submagic.connectorbay.com/openapi.json
Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
Authentication: your own Submagic Submagic API key (starts with sk-), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
Health: https://byok-submagic.connectorbay.com/health · Tool schemas: https://byok-submagic.connectorbay.com/tools.json
Publisher: Unify Dynamics LLC · connectorbay.com/byok-submagic · agent@connectorbay.com

What Submagic (BYOK) is for

Submagic (BYOK) lets an AI assistant read your own Submagic data through the Submagic API with a key you supply (Submagic API key (starts with sk-)). Read-only: 9 tools (list_languages, list_templates, list_hook_title_templates, list_user_media, get_project, list_presets, get_preset, list_published_projects, get_publication). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.submagic.co. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Submagic. Submagic and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

"Which languages does Submagic support?"
"What caption templates does Submagic offer?"
"Which hook title templates can I use in Submagic?"
"What videos are in my Submagic media library?"
"Is Submagic project 550e8400-e29b-41d4-a716-446655440000 finished?"
"What Submagic presets have I saved?"

What it does

list_languages: List the languages Submagic can transcribe and caption, with their codes.
list_templates: List the names of the built-in caption templates that can be used when creating projects.
list_hook_title_templates: List the names of the hook-title templates available for projects.
list_user_media: List files in the media library (videos, audio, images) with size, duration and upload date; cursor paging.
get_project: Get a Submagic project: title, status (processing to completed), language, template, effects switched on, video details and download or preview URLs. The word-by-word transcript is left out.
list_presets: List saved presets (caption, hook title and effect settings reused across projects); cursor paging.
get_preset: Get one preset: its name and which captions, hook title, zooms and B-roll settings it applies.
list_published_projects: List projects published to social platforms with views, engagement and per-platform post analytics; filter by platform and date, sort by views.
get_publication: Get one publication: status, totals and per-platform post links and analytics.

BYOK key

You bring your own Submagic Submagic API key (starts with sk-) (https://app.submagic.co/). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.submagic.co over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

https://docs.submagic.co/llms.txt (the API this connector calls, with a BYOK key)

Live from the Submagic API (api.submagic.co) with a BYOK key; documentation: https://docs.submagic.co/llms.txt. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Submagic. Submagic and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Submagic account.

Built for: Worldwide. Languages: English.