Second Studio

ブランド付き解説動画や参考資料に基づく編集向けのホスト型動画MCPサーバー。

ホスト型 MCP サーバー

npx add-mcp 'https://secondstudio.dev/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

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):

  1. The app registers itself (POST https://secondstudio.dev/oauth/register). A redirect URI must be https on a public hostname, or http on localhost, 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.
  2. You sign in and pick a workspace.
  3. The app exchanges the code at POST https://secondstudio.dev/oauth/token and refreshes it there. Access tokens last one hour. Refresh tokens rotate. The authorization request and the code exchange must send resource=https://secondstudio.dev/mcp (RFC 8707). A refresh must send the same resource if it sends one.
  4. The client calls the MCP server with Authorization: Bearer and the access token. Revoke a token at POST 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

ToolWhat it doesCredits
whoamiAccount, key scope and settingsn/a
get_creditsBalance, prices and packsn/a
buy_creditsStripe 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 diskn/a
create_upload_url + register_asset (remote)Upload in two stepsn/a
get_asset, list_assets, delete_assetManage filesn/a
fetch_videoA reference from a social URL. Direct hosts are 1 credit. Proxied hosts such as Instagram are 3, plus 1 per extra 25 MB1 or 3
analyze_styleReference video to a reusable style2 for the first minute, then 1 per extra minute (10 min max)
get_style, list_stylesRead styles, including the full specn/a
list_templates, get_template, save_template, delete_templateSocial videos saved to replicatefree (3 with analyze)
list_clip_templatesBuilt-in clip looks (secondstudio_home and the rest). Not saved social videos.free
create_clip_job, get_clip_job, list_clip_jobsRanked clips from a long video. template_id picks a clip look.1 per minute + 1 per clip
rerender_clipRender one clip again. template_id re-encodes when the look changes.1
create_editYour clips cut to a style5
record_urlRecord a public web app3
record_repoBuild 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 details20 for up to 3 flows, 4 per extra flow
connect_githubAdmin: link to install the GitHub App on chosen repositoriesfree
repo_connect, repo_listConnect a repository the app can already read, and list themfree
repo_indexRead a repository into docs and skills. estimate: true is a free quote12 + 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_getIndex status and the docs (paths, no code quotes)free
create_character, get_character, list_characters, delete_characterStored identities you can reuse by idlike one image
create_brand, get_brand, list_brands, delete_brandBrand kits for explainer videosn/a
write_scriptAn editable scene-by-scene explainer script from a brief. Optional repo_id and skill_ids2
create_explainerA rendered, branded explainer video from a brief or script. Optional repo_id and skill_ids12 first minute, +7 per extra minute
generate_imageCharacter sheets, characters, locations, props, scenes, productsGPT Image 6 / 16 / 48 at 1K / 2K / 4K. A character sheet is twice that
generate_iconsA 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 free5 per icon
regenerate_iconOne icon again, keeping the set's style lock5
list_icon_sets, get_icon_setRead icon sets and their SVG and PNG filesfree
generate_videoVideo 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_voicePerformed voiceover2 minimum, then 1 per 250 characters
lipsyncRe-time a mouth to an audio track15 min, 1.25 per second
get_job, list_jobsJob status and outputsn/a
list_social_accountsConnected accountsn/a
connect_social_accountA link to connect a new accountn/a
create_post, list_postsDraft and track posts1 per post
create_post_approval, get_post_approval, list_post_approvalsEmail a preview for approval. The approver confirms on a page. on_approve: publish posts only when the account scheduler is onfree until a publish is approved
create_post_approval_digestOne email for up to 20 posts, with buttons on eachfree until a publish is approved
list_crewThe crew: preset robots and the tools each bundlesfree
get_robotOne robot's skills, tools, endpoints and starter promptfree
list_lighting_presetsThe twelve lighting presets (id, name, description) for generate_videofree
list_modelsImage, video and swap models and what each supportsn/a
create_skill, upload_skill, list_skills, get_skill, update_skill, delete_skillYour 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 restfree
skill_regenerateRewrite one codebase skill. Pinned, custom, and edited skills get a proposal4
skill_versions, skill_restoreList versions and restore one, including a codebase skill deleted within 30 daysfree
edit_imageMasked edit of a real photo, rest untouchedper image
swap_character, motion_transferKeep the footage, change the subjectquoted
finalize_video, cancel_job, upscale_videoDrafts → 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 resamplequoted / n/a / 3
libraryEverything the team can reuse by id, with who made it, plus foldersn/a
list_foldersLibrary folders (id, name, auto, count). auto is true when the studio created the foldern/a
create_folderCreate a folder by name, or return the existing one. All and Unfiled are reservedn/a
rename_folderRename a folder and clear auton/a
merge_foldersMove every item into another folder, then delete the source foldern/a
delete_folderDelete a folder. Items go back to Unfiled. Files stayn/a
move_to_folderMove up to 100 videos and images into a folder (folder_id null sends them to Unfiled). Does not delete themn/a
search_libraryOne page of the library, filtered by title, kind, folder, and tagn/a
tag_assets, untagAdd or remove tags on up to 100 items. square, vertical, and landscape are format tagsn/a
organize_libraryPreview 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 anythingn/a
list_members, invite_member, update_member, remove_member, create_member_key, list_keys, revoke_key, pause_key, resume_keyTeam 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_inviteInvite 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_teamTeams and managers (governance accounts; admin to change)none
list_budgets, allocate_budget, set_member_allowance, revoke_budget, set_key_credit_cap, list_auditMember 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_providerYour own Higgsfield / ElevenLabs keys (admin, where enabled)n/a
list_voices, clone_voice, delete_voiceYour workspace's voices and clones from your sampleslike voice
analyze_brandA suggested brand kit from your boards1
import_brand_from_urlImport 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_importSave a mode: "review" import draft as the brand kit.0
discard_brand_importDrop a mode: "review" import draft. Nothing is saved.0
brand_from_websiteBrand 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_reportsFile a bug, feature request or question; follow the responsen/a
feedback, /feedback promptSend 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
folderName, or an id from list_folders. This is the only field that creates a normal folder (auto: false).
projectProject name. Used when folder is omitted. Wins over campaign if both are set.
campaignCampaign name. Same place in line as project.
productProduct 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."