Second Studio
Servidor MCP de video alojado para videos explicativos de marca y ediciones basadas en referencias.
Servidor MCP alojado
npx add-mcp 'https://secondstudio.dev/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Connect an agent (MCP)
Connect an agent (MCP)
Second Studio speaks the Model Context Protocol. The server is hosted. Add the URL and sign in. There is nothing to install and no API key to copy.
URL: https://secondstudio.dev/mcp · Transport: Streamable HTTP
Claude Code
claude mcp add --transport http second-studio https://secondstudio.dev/mcp
Cursor (.cursor/mcp.json), Windsurf, and other clients with a JSON config
{
"mcpServers": {
"second-studio": {
"url": "https://secondstudio.dev/mcp"
}
}
}
Claude Desktop, ChatGPT, and other apps with connectors: add a custom connector with
https://secondstudio.dev/mcp, then choose Connect.
The client opens a browser. Sign in on https://secondstudio.dev/signin/ (the same account as the app), pick a
workspace if you belong to more than one, and approve. The app can make videos and drafts in that
workspace. It cannot approve posts.
Disconnect an app under Agent keys in the app. That revokes its tokens immediately. Your API keys stay active.
A request with no token gets 401 and a WWW-Authenticate header that points at the protected-resource document:
https://secondstudio.dev/.well-known/oauth-protected-resource
That document names the authorization server on the same host. Its metadata is at
https://secondstudio.dev/.well-known/oauth-authorization-server (RFC 8414). The same protected-resource document is also at
https://secondstudio.dev/.well-known/oauth-protected-resource/mcp.
The flow is OAuth 2.1 with PKCE (S256):
- The app registers itself (
POST https://secondstudio.dev/oauth/register). A redirect URI must behttpson a public hostname, orhttponlocalhost,127.0.0.1, or[::1]. A loopback port may differ from the one that was registered. A private-use scheme in the same registration is ignored. - You sign in and pick a workspace.
- The app exchanges the code at
POST https://secondstudio.dev/oauth/tokenand refreshes it there. Access tokens last one hour. Refresh tokens rotate. The authorization request and the code exchange must sendresource=https://secondstudio.dev/mcp(RFC 8707). A refresh must send the same resource if it sends one. - The client calls the MCP server with
Authorization: Bearerand the access token. Revoke a token atPOST https://secondstudio.dev/oauth/revoke.
The connection uses your role or a lower one. It is never an admin and never the owner. An admin who connects an app gets a creator key. A manager, creator, or reviewer keeps that role. It uses that person's monthly credit cap or monthly budget when they have one. Otherwise the monthly cap is the starter credit amount. Credits come out of the workspace balance, with the same rate limits as an API key. An API key and a signed-in app can be used at the same time.
Advanced: API keys
Use an API key for scripts, curl, or a client that cannot open a browser. The agent key cannot approve posts.
Keep it in SECOND_STUDIO_API_KEY, never in chat or a repo:
export SECOND_STUDIO_API_KEY="ss_live_..."
claude mcp add --transport http second-studio https://secondstudio.dev/mcp --header "Authorization: Bearer $SECOND_STUDIO_API_KEY"
{
"mcpServers": {
"second-studio": {
"url": "https://secondstudio.dev/mcp",
"headers": { "Authorization": "Bearer ${env:SECOND_STUDIO_API_KEY}" }
}
}
}
Authorization: Bearer with an API key stays valid on MCP and on the REST API at https://secondstudio.dev/v1.
GET /v1/me checks the key. The prompt at /setup.txt tells an agent to sign in first and to ask for a key only for scripts.
Uploads go to a one-time upload URL from upload_asset, and agents poll get_job until a job finishes.
Tools
| Tool | What it does | Credits |
|---|---|---|
whoami | Account, key scope and settings | n/a |
get_credits | Balance, prices and packs | n/a |
buy_credits | Stripe Checkout link for a pack (pack), a custom amount (pack: "custom", credits 200 to 50,000 at $0.10 each, $20 minimum) or a plan (plan). A person opens the link and pays. | n/a |
upload_file (local) | Upload a file from disk | n/a |
create_upload_url + register_asset (remote) | Upload in two steps | n/a |
get_asset, list_assets, delete_asset | Manage files | n/a |
fetch_video | A reference from a social URL. Direct hosts are 1 credit. Proxied hosts such as Instagram are 3, plus 1 per extra 25 MB | 1 or 3 |
analyze_style | Reference video to a reusable style | 2 for the first minute, then 1 per extra minute (10 min max) |
get_style, list_styles | Read styles, including the full spec | n/a |
list_templates, get_template, save_template, delete_template | Social videos saved to replicate | free (3 with analyze) |
list_clip_templates | Built-in clip looks (secondstudio_home and the rest). Not saved social videos. | free |
create_clip_job, get_clip_job, list_clip_jobs | Ranked clips from a long video. template_id picks a clip look. | 1 per minute + 1 per clip |
rerender_clip | Render one clip again. template_id re-encodes when the look changes. | 1 |
create_edit | Your clips cut to a style | 5 |
record_url | Record a public web app | 3 |
record_repo | Build a private GitHub repository and record its key flows. Optional repo_id and skill_ids add path notes. 4 more credits when it signs in. If a job fails because of a problem on our side, we usually refund the credits automatically. Refunds are made in credits, not money. See the Terms for details | 20 for up to 3 flows, 4 per extra flow |
connect_github | Admin: link to install the GitHub App on chosen repositories | free |
repo_connect, repo_list | Connect a repository the app can already read, and list them | free |
repo_index | Read a repository into docs and skills. estimate: true is a free quote | 12 + 0.12/file, cap 400. A later commit is 6 + 0.12 per changed file, and at least 2.5x of the planning cost |
repo_index_status, repo_docs_get | Index status and the docs (paths, no code quotes) | free |
create_character, get_character, list_characters, delete_character | Stored identities you can reuse by id | like one image |
create_brand, get_brand, list_brands, delete_brand | Brand kits for explainer videos | n/a |
write_script | An editable scene-by-scene explainer script from a brief. Optional repo_id and skill_ids | 2 |
create_explainer | A rendered, branded explainer video from a brief or script. Optional repo_id and skill_ids | 12 first minute, +7 per extra minute |
generate_image | Character sheets, characters, locations, props, scenes, products | GPT Image 6 / 16 / 48 at 1K / 2K / 4K. A character sheet is twice that |
generate_icons | A set of icons from a brand kit and its style skills. brand_id picks the kit. Omit it to use the primary kit. estimate: true is free | 5 per icon |
regenerate_icon | One icon again, keeping the set's style lock | 5 |
list_icon_sets, get_icon_set | Read icon sets and their SVG and PNG files | free |
generate_video | Video shots, from text, an image or references (+ a voice track). Optional lighting is a preset id from list_lighting_presets. Omit it and the light stays with the brief. An unknown id is rejected. The quote does not change. | quoted per request |
generate_voice | Performed voiceover | 2 minimum, then 1 per 250 characters |
lipsync | Re-time a mouth to an audio track | 15 min, 1.25 per second |
get_job, list_jobs | Job status and outputs | n/a |
list_social_accounts | Connected accounts | n/a |
connect_social_account | A link to connect a new account | n/a |
create_post, list_posts | Draft and track posts | 1 per post |
create_post_approval, get_post_approval, list_post_approvals | Email a preview for approval. The approver confirms on a page. on_approve: publish posts only when the account scheduler is on | free until a publish is approved |
create_post_approval_digest | One email for up to 20 posts, with buttons on each | free until a publish is approved |
list_crew | The crew: preset robots and the tools each bundles | free |
get_robot | One robot's skills, tools, endpoints and starter prompt | free |
list_lighting_presets | The twelve lighting presets (id, name, description) for generate_video | free |
list_models | Image, video and swap models and what each supports | n/a |
create_skill, upload_skill, list_skills, get_skill, update_skill, delete_skill | Your skills library for image, video, audio, text, character, style and other skills, with files. upload_skill imports a SKILL.md or .zip. Ids or slugs work. Pass skill_ids to generate_image, generate_video, generate_voice and the rest | free |
skill_regenerate | Rewrite one codebase skill. Pinned, custom, and edited skills get a proposal | 4 |
skill_versions, skill_restore | List versions and restore one, including a codebase skill deleted within 30 days | free |
edit_image | Masked edit of a real photo, rest untouched | per image |
swap_character, motion_transfer | Keep the footage, change the subject | quoted |
finalize_video, cancel_job, upscale_video | Drafts → keeper, cancel (credits come back if the job has not started on a worker yet; after that the reservation is kept). Refunds are made in credits, not money. 2160p resample | quoted / n/a / 3 |
library | Everything the team can reuse by id, with who made it, plus folders | n/a |
list_folders | Library folders (id, name, auto, count). auto is true when the studio created the folder | n/a |
create_folder | Create a folder by name, or return the existing one. All and Unfiled are reserved | n/a |
rename_folder | Rename a folder and clear auto | n/a |
merge_folders | Move every item into another folder, then delete the source folder | n/a |
delete_folder | Delete a folder. Items go back to Unfiled. Files stay | n/a |
move_to_folder | Move up to 100 videos and images into a folder (folder_id null sends them to Unfiled). Does not delete them | n/a |
search_library | One page of the library, filtered by title, kind, folder, and tag | n/a |
tag_assets, untag | Add or remove tags on up to 100 items. square, vertical, and landscape are format tags | n/a |
organize_library | Preview folders, moves, and format tags. A second call with confirm: true and plan_id applies it, in batches past 100. The preview does not move anything | n/a |
list_members, invite_member, update_member, remove_member, create_member_key, list_keys, revoke_key, pause_key, resume_key | Team members, roles, keys, credit and dollar caps, claim links (admin). A paused key cannot resume itself. | n/a |
list_invites, invite_by_email, create_invite_link, revoke_invite | Invite by email (joins on Google sign-in) or by expiring link (admins; managers into their team) | none |
my_memberships, list_teams, create_team, update_team, delete_team, set_member_team | Teams and managers (governance accounts; admin to change) | none |
list_budgets, allocate_budget, set_member_allowance, revoke_budget, set_key_credit_cap, list_audit | Member and team credit budgets, a weekly or monthly allowance per person, per-key caps, audit log (admins; managers inside their team) | none |
list_providers, connect_provider, disconnect_provider | Your own Higgsfield / ElevenLabs keys (admin, where enabled) | n/a |
list_voices, clone_voice, delete_voice | Your workspace's voices and clones from your samples | like voice |
analyze_brand | A suggested brand kit from your boards | 1 |
import_brand_from_url | Import a brand from its guidelines page or brand book PDF: logo, colors, fonts, voice and tone, taglines, do's and don'ts, imagery notes. Fills a kit you pick or creates one, and every field stays editable. Default mode: "apply" saves straight away; mode: "review" returns a draft and saves nothing until you approve it. Also on the Brand tab in the dashboard, which always reviews first. | 1 |
approve_brand_import | Save a mode: "review" import draft as the brand kit. | 0 |
discard_brand_import | Drop a mode: "review" import draft. Nothing is saved. | 0 |
brand_from_website | Brand guidelines from your public website (colors, font, tone, audience, products, voice rules), saved to a brand kit without overwriting your edits. New accounts with a work email get one free scan of their domain at signup. | 1 |
report_issue, list_reports | File a bug, feature request or question; follow the response | n/a |
feedback, /feedback prompt | Send product feedback to the team (10 per hour per key) | 0 |
The /feedback prompt (MCP prompt feedback) asks what you want to share, then sends it with the feedback tool. It is free.
When you create a video or image, pass one of these. A folder name that does not exist is created. Names All and Unfiled are reserved.
| Field | |
|---|---|
folder | Name, or an id from list_folders. This is the only field that creates a normal folder (auto: false). |
project | Project name. Used when folder is omitted. Wins over campaign if both are set. |
campaign | Campaign name. Same place in line as project. |
product | Product name. Used when folder, project, and campaign are omitted. |
If you pass none of them, the item is filed from the brand name, then a short style or template title, then a kind default such as Videos, Explainers, Edits, Recordings, References, or Images. A long style summary is not a folder name. That folder is marked auto and is created only when the job produces a library file. estimate: true does not create a folder. list_folders returns each folder's id, name, auto, and count. move_to_folder moves videos and images; folder_id null sends them back to Unfiled. delete_folder does the same for a whole folder.
search_library filters by title, kind, folder, and tag. New videos and images get a format tag from their aspect ratio: square, vertical, or landscape. Folders stay one axis, the campaign or topic. organize_library with no confirm returns a plan id, proposed folders, moves, and tags. It changes nothing. Call it again with confirm: true and that plan_id to apply the plan. Moves are applied in batches of 100, so a plan can be larger than one move_to_folder call. Do not confirm a plan unless the person asked.
The same fields exist on generate_video, generate_image, create_explainer, create_edit, fetch_video, record_url, record_repo, swap_character, motion_transfer, upscale_video, finalize_video, and edit_image.
Approving posts is deliberately not a tool. A person approves with the admin key: see Posting.
Example prompts
- "Analyze ./refs/viral.mp4 and tell me what makes its editing work."
- "Make three 15-second edits of ./footage in the style of that reference, with different hooks."
- "Record our pricing page at https://example.com/pricing on mobile, then cut it to my saved style."
- "Draft the best one to our TikTok for tomorrow 6pm Eastern."