ai.switchapp/switch
ai.switchapp/switchGenerate, manage and explore your Switch AI image and video library, scoped to your account.
Score: 100/100
Handshake verified by our own probe.
Tools · 133
List your authorized Premiere connections. Call this first: each connection carries the deviceId every other Premiere tool needs. No footage is uploaded.
Read the sequence shared by your Premiere panel, including names, timing and a revision. Inspect readAt for freshness. No footage bytes. First call premiere_list_connections to get the deviceId of you…
Before planning motion, load playbook/motion-design (timing, easing, choreography, depth, sound). Send one typed edit operation, a list of 1 to 20 operations (one batch: one Undo in Premiere when ever…
Build the numbered V1 shot log (SH001, SH002…) from the sequence your Premiere panel shares: timeline in and out, source in and out, duration (timecode and exact ticks), source file, clip reference, a…
Read an edit outcome. Only done means Premiere reported verified readback; cancelled requests already running may finish. First call premiere_list_connections to get the deviceId of your connected Pre…
Cancel a pending Premiere edit. An Adobe transaction already running may finish. Read its final status. First call premiere_list_connections to get the deviceId of your connected Premiere panel.
See one frame of the sequence your Premiere panel shares, at a given second. The panel exports the frame itself (nothing in the project changes) and the picture comes back here as an image plus its ad…
List your authorized After Effects connections. Call this first: each connection carries the deviceId every other After Effects tool needs. No footage is uploaded.
Read the composition shared by your After Effects panel: its settings, every layer with its key (L1, L2…), in and out frames, transform and expressions (a property with keyframes or an expression swit…
Before planning motion, load playbook/motion-design (timing, easing, choreography, depth, sound, expression recipes). Send one typed edit to your approved After Effects composition for review. Kinds: …
Read an edit outcome. Only done means After Effects reported verified readback; a done edit carries snapshot.fresh (true once the shared composition shows the edit; it waits a few seconds for it) and …
Cancel a pending After Effects edit. A render or edit already running may finish. Read its final status. First call aftereffects_list_connections to get the deviceId of your connected After Effects pa…
Render the shared composition with aerender in the background and put the movie in the Switch library. The project must be saved. Poll aftereffects_edit_status until done; result.assetId is the librar…
Browse the image-generation models available to your Switch account: exactly the models generate_image accepts, each with the model name to pass and the tokens one picture takes (the same number the c…
How many tokens you have left: your token balance, the tokens spent today, and any daily limit with what remains. Use this whenever someone asks how many tokens or credits they have. Optionally pass a…
What your calls cost: every charge on this account over the last `hours` (default 24), newest first, each with what it was for, the model, the tokens it was worth, the tokens actually taken, and the d…
List your recent and active picture generations: queued batches and the pictures generate_image made right in the chat. Returns counts per status (pending / running / completed / failed) plus an array…
Get the full detail of one of your generations by its id — prompts, model, ref counts, saved/failed counts, ETA hint, asset ids. Also takes a video task or job id (from generate_video) and an audio ge…
Polling-friendly status check for one of your jobs: a picture task (generate_image), a video (the task_id or job_id from generate_video) or an audio take (a generation_id or a rendering request_id). R…
Display the user's images inline — one or many. Users speak plainly and will NOT know asset ids; never ask for one, resolve it yourself. For "show me" or "show me my last image" call with NO arguments…
List the folders in your Switch library (id, name, parent, and when each was made, so the newest can be found). Use this to find an existing folder and its id; search_my_library looks inside your libr…
Return your asset METADATA only (id, truncated prompt, model, created date), newest first. This does NOT display images and must NOT be used to show pictures — if the user says "show me / display my l…
Search your library. It understands meaning as well as words: a picture is found when its prompt holds your words, and also when the picture itself fits what you describe, even if those words were nev…
Read your staged references in Switch Studio. Returns TWO groups: (1) the image-generation reference strip (typed face/body/outfit/scenery/product slots) under `refs`, and (2) the VIDEO-tab references…
Load once when starting production on your video and the workflow is not already known. Not needed for an ideas question. Loads the current MCP-only production rules, BytePlus Seedance routing policy,…
Load one shared production playbook by id (ids come from load_video_workflow) and apply it to your production. A playbook is an anonymized record of how a real Switch production went: the shot list th…
List the Switch Styles you can use for your edits, the short codes for editing a talking video (O Openers, W Words, F Frames, R Receipts, B Beats, U App Moments, K Kicks, M Motion Graphics, S Web, P P…
Get the short style card and the full edit prompt for the Switch Style codes you pick (for example "O10 W1 F4 B6 A2 G4", or your own learned style such as "Y1"), or a 4 to 6 code suggestion for the fe…
Talk to Switch's unrestricted operator (the unrestricted mode in the Studio chat): the mature, uncensored creative brain that runs on BytePlus with its own workspace, tools and skills. Send your brief…
Allow or deny one action the unrestricted operator asked for (from pending_action.action_id in an ask_switch_unrestricted answer): generate images, save a reference, run a workspace command, write a f…
THE one tool for a prompt rewrite: when the person asks to rewrite, fix, improve or check their prompt, call this once and show the result; load no playbook and run no other step for it. SwitchApp Vid…
Get the current server price in Switch tokens before video generation. Uses the same billing calculator as submission and measures your stored reference clips. Pass one shot using the same model, mode…
How many seconds a video clip should be for a spoken line, so the words are never rushed or dragged. Give it the spoken text (or a word_count) and it returns a suggested duration for four delivery ene…
Phone-shot amateur look — looks like a real person snapped it on their phone. Casual, candid, pore-level real, no professional gloss. Three flavors: digital phone, 35mm film point-and-shoot, or off-du…
Put me in a movie — full cinematic film look matching specific film genres. Choose: neon-noir action thriller, 80s finance excess, comic-book superhero blockbuster, video-game key art, or generic acti…
High-fashion magazine cover/editorial energy. Choose a mood: glossy cover, dark cinematic, hard-flash conceptual, painterly Renaissance, dreamlike fairy-tale, black-and-white natural, or off-duty cand…
Sharp graphic editorial portrait — premium fashion-magazine grade, hard graphic composition. Classic studio or golden-hour outdoor. Returns the styled prompt stack for your shot and the aspect_ratio t…
Luxury travel + hotel editorial. Real architecture is preserved exactly (no inventing buildings). Choose subject: hotel hero, rural property, scenic view, drone aerial, lifestyle moment, or interior. …
Wellness / yoga / fitness / lifestyle campaign — warm amber tropical, tropical paradise cinematic, or high-key cyan beach. Returns the styled prompt stack for your shot and the aspect_ratio to make it…
ARRI Alexa anamorphic widescreen film look. Choose grade: warm golden, cool noir, or moody desaturated. Returns the styled prompt stack for your shot and the aspect_ratio to make it at — pair it with …
Golden-hour rim-light editorial portrait. Choose camera: Canon R5 + 85mm f/1.2 or Hasselblad H6D + 80mm. Returns the styled prompt stack for your shot and the aspect_ratio to make it at — pair it with…
Product photography. Choose: clean studio hero shot, real-world lifestyle, extreme macro detail, or top-down flat lay. Returns the styled prompt stack for your shot and the aspect_ratio to make it at …
User-generated content — looks like a real person captured it casually. Choose: phone shot, film point-and-shoot, mirror selfie, or car selfie. Returns the styled prompt stack for your shot and the as…
Generate Switch images with one of eight models: GPT Image 2.5, Switch Pro, Seedream 5.5, Switch Ultra, Nano Banana 2.1 (Google's newest, up to 14 reference pictures), Nano Banana 2, Nano Banana Pro o…
Stop one of your picture, video or sound jobs by its id. Pictures: works on queued and running tasks; pictures already made stay in your library. For a background batch, the cancel is sent to the pict…
Generate video with the configured provider lineup (Kling, BytePlus Seedance, Switch Video/WAN 2.7, Switch Video Edit, Higgsfield Genjutsu, Topaz upscale) and modes (text-to-video, image-to-video, fra…
List the video providers, models, and modes available to your Switch account, with each model's required inputs, allowed aspect ratios and durations, and a rough per-second cost. Use this when the sel…
Check the status of one of your video jobs by task_id (from generate_video) or job_id. Returns status, a viewable view_url when finished, or the error if it failed (a video Higgsfield Genjutsu turned …
List your recent Switch videos, newest first: id, status, prompt, model, and a viewable view_url for finished clips. Use this when someone asks to see their last or recent videos, to check whether vid…
Upscale and enhance one of YOUR videos (or a public https clip) with Topaz. Full control: scale 1 to 4 (1.5x works), optional target_fps 16 to 60 where the selected model supports it, and the Topaz mo…
List the video upscalers you can run on your videos, their provider routes, supported controls, and release availability. Uses the same catalog as Video on desktop and mobile. Does not start a job or …
Main SwitchApp lip-sync for your videos. Uses Switch lip sync (Sync 3) only — never Kling. Call action="create" with video_url plus either sound_file (a base64 audio data URI) or audio_url; then call …
Lip-sync audio onto one of your videos. For action="create" without engine, session_id, or face_id, the default is Switch lip sync (Sync 3): video_url + sound_file (base64 data URI) processes the whol…
Turn a face photo into a lip-synced talking-head video that speaks your text (or your audio). Provide image_url (a clear face photo) and either script (text to speak, max 2500 characters) or audio_url…
Your saved voices — one tool for the whole voice library. Users speak plain language and never know ids: resolve every voice by NAME yourself (call action "list" first if unsure) and never ask the use…
Generate spoken audio from text: narration, a voiceover, a read-aloud script, or a multi-voice dialogue. Pass text (up to 3000 chars) — the words to be spoken. To speak in one of YOUR saved voices, pa…
Collect one of your finished audio takes. When generate_audio answers status "rendering" with a request_id (a longer line), call this with that request_id every 15 seconds until it returns status "don…
List your recent audio takes (voice lines, narration, dialogue) newest first, each with a playable audio_url, duration_seconds, the words spoken, its generation_id and made_with: the voice that spoke …
Find sound effects, music beds and ambience for your video in the Switch Motion Sound Library (952 level matched sounds: whooshes, swooshes, transitions, hits, chimes, UI clicks, typing, risers, glitc…
Find licensed music tracks and sound effects in the Epidemic Sound catalogue, open to every account at no token cost. Search first with plain words for the moment; leave kind out to get both sound eff…
Make a music bed or one short sound hit for an edit (the beat-and-hits editor workflow), with no voice and no words. kind "bed" gives an instrumental bed of about `seconds` (4 to 60, default 15) to ru…
Make one sound effect from plain words with ElevenLabs SFX v3 (it follows several instructions in one prompt, for example "crowd cheering, then a ball drops, then booing", and handles vocal and musica…
Pull one described sound out of your video, like "keyboard clicks", "camera shutter" or "page turning", and split it into single effects to hear, trim and save. Use the video already in the chat: put …
Where your sound extraction from extract_sound_effect is, by its job_id: still separating, done with its clips (name, link, where each sits in the video), stopped or failed. Reading it also finishes a…
Lay one of your saved sounds (a sound effect you saved, by its id from list_my_audio) or a sound in this chat onto your video at a given second, keeping the video's own sound under it unless keep_orig…
Speak written words out loud in an ElevenLabs voice and save the audio to your library. Give it the words and the voice (a voice name, or a voice id from list_voices). Every take speaks on Eleven v4 o…
Make ONE audio file, saved to your library, of two or more people talking to each other, spoken by ElevenLabs v3 (or v4, with model). Give it lines in order, each with the voice who says it (a voice n…
Take a recording of someone speaking and have it said again in a different voice, keeping the original performance exactly: the pauses, the timing, the emphasis and the feeling all stay, only who is s…
List the voices available to speak with: the ready-made library voices plus every voice this account has cloned or designed. Each one comes back with its voice_id (pass that to the speaking tools), it…
Make an instant voice clone of a real person from one or more clips already in your library. What makes a good sample: one person talking and nobody else, no music and no background noise, normal spea…
Invent a brand-new voice from a written description instead of cloning a real person: no consent needed and nobody owns it. Describe who they are, how old they sound, their accent, their pace and thei…
Remove one of your own voices for good and free the space it was using. Only works on a voice you cloned or designed yourself: the ready-made library voices cannot be removed. This cannot be undone, s…
Clean up and share your own saved voices (Seed Audio voices from a clip and trained voices), the same as the voice list in Audio Studio. action "delete" removes a voice for good (audio already made wi…
Write out everything said in a recording, with the exact second every word starts and ends. Give it the asset id of a clip in your library (or an https link) and you get back the full text, the langua…
Get the word times for a take you already have, so captions and cuts land on the word. Give it the recording (an asset id from your library, or an https link) and the script that is spoken in it, and …
Make a music track with ElevenLabs Music: a song, a score, a background bed. Either describe the whole track in prompt (genre, mood, instruments, tempo, era, how it builds) or pass a plan you got from…
Write a soundtrack for a video from the video itself, with ElevenLabs Video to Music: it watches the cuts, pace and mood and scores them. Use it when the customer asks for music made for their video (…
Draft the plan for a music track before any of it is made, and before anything is charged. Describe the track you want for your edit and this returns the structure the music maker intends to build: a …
Pull the voice out of a noisy recording with the ElevenLabs voice isolator. Traffic, room echo, air conditioning, crowd, hiss and any music behind the speaker all come off and the speech stays, so a p…
Say a recording again in another language with the speakers kept sounding like themselves, using ElevenLabs dubbing. Pass source (an id from your library or a public https link) and target_language as…
THE upload door for references. Upload an image, video, or audio reference into your Switch cloud and get an opaque asset_id (never a raw storage URL) to pass in reference fields. Pictures of real peo…
Stitch several of your Switch videos together into ONE video, played back-to-back in the order you give. Pass clip_asset_ids: an ORDERED list of your video ids (from list_my_videos), the file ids of v…
Stitch your videos together in the Switch Editor: puts the given videos on a fresh Editor timeline in the order given and returns the Editor address, where the cut plays in the preview and Export rend…
Switch Vision — watch and understand a video (or image) like a human and answer a question about it: scenes, subjects, actions, on-screen text, pacing, mood and sentiment. With timeline true it is Gem…
Say what it costs to log the shots of your Editor project (or one shared with you): every clip on the video track becomes SH001, SH002 … with its timeline and source in/out, and Gemini watches each on…
Log the shots of your Editor project (or one shared with you) after the customer said go to the quoted price: numbers every clip on the video track (SH001 …) with timeline and source in/out, then Gemi…
Read or export the shot log of your Editor project (or one shared with you): format "json" (every field), "csv" (a sheet: shot number, timeline in/out, duration, source file, source in/out, descriptio…
Put a finished video on your Switch Editor project's timeline from its https link (an InVideo export, a Switch render, any video you own). It lands at the end of the timeline and in the project's medi…
Read the timeline of your Editor project (or one shared with you) track by track: every clip with its index, label, start, end, length, in and out points in its file, link, speed, volume and fades; th…
Edit the timeline of your Editor project (or one shared with you) the way a person does with the mouse, in one call: place a clip at a time on a track, trim either edge, split, move, delete, ripple de…
Export an Editor project to an MP4 the way the Export button does: the row of clips on the video tracks is joined (cuts, sound shapes, frames) with every sound clip on the audio tracks mixed in at its…
Where your export_editor_project export is: queued, rendering, complete (with the MP4 link and renderChecks: the finished file checked for black gaps, blank screens, frozen stretches, missing layers, …
Find the scene changes in a video of your Editor project (or one shared with you): the seconds in the file where the picture cuts, read by ffmpeg. Use them with edit_editor_timeline split_scenes (cut …
See your finished Editor render at the seconds you name: one still per second comes back as a picture, in the order asked (20 per answer; any more come back named in still_to_look_at for the next call…
See your whole finished Editor render on one picture: one frame every N seconds (default 1), left to right, top to bottom; a step that would pass 100 frames widens to fit and says so. Look at it befor…
Turn a video into a DEPTH MAP: a grayscale video where brightness encodes distance, used as a motion reference so a new generated subject moves exactly like your source clip. Pass video_url (a public …
Check one of your depth map renders started with create_depth_map. Pass the task_id it returned. While rendering it reports processing; when finished it returns depth_video_url, a download link for th…
Run the FULL Switch Vision analysis on a video, the same premium report the Video Analysis page produces: it watches AND listens in three forensic passes and returns a structured report with every cat…
Fetch one of your finished Video Analysis reports by report_id (from analyze_video_report or list_vision_reports). Returns the complete structured report: overview scores and takeaways, the timeline o…
List your Video Analysis history, newest first: report_id, date, status, source kind, duration, engine, tokens charged, and each report's headline. Use it to find a past analysis, then pass its report…
Turn one of your finished Video Analysis reports into ONE reusable generation prompt that recreates the source video's look, energy, pacing and mood, with a {your photo} placeholder where your own sub…
Separate one of your own Switch images into editable layers: a base plus transparent PNG layers, each named and placed. Seedream 5.0 Pro (the default) makes up to 16 layers. Seedream 5.5 (pass model) …
Open one of your own layers projects: every layer with its name, description, stacking order, whether it is showing, and where it sits on the picture. Use this before arranging layers so you know thei…
Arrange your own layers project: swap one layer's picture for another picture of yours (replace_with), show or hide a layer, move or resize it (box as [left, top, right, bottom] in the base picture's …
Save the current arrangement of your own layers project as a finished picture in your library, composited at full quality from the original layer files. The project stays editable and you can flatten …
Prepare a private, short-lived download link for your own layers project: a ZIP holding every original transparent PNG plus a manifest of names, order, boxes and visibility, ready for Photoshop or Fig…
Create a clean, persistent project in your real Switch Editor. The same project opens in the /editor UI and is used by the Editor agent and HyperFrames renderer.
List your persistent Switch Editor projects, newest first, with media, scene, composition and render counts. Optional search matches the project name. Each project carries its own media and its saved …
Inspect one of your persistent Switch Editor projects. Omit project_id for your latest project; include_payload=true returns its full editable state.
Permanently delete one of your Switch Editor projects: the project, its saved chat history for every brain, and its workspace and capture files, and the files uploaded to it that no other project of y…
Share one of your Switch Editor projects with a team member by their Switch account email, stop sharing it, or list who has it. A shared project opens for them with its media, its chat history and its…
Put image, video or audio files into your real Switch Editor project. By default they land in the project's media bin only; pass place: true to also lay each one at the end of its track. Three ways: u…
Add images you own in your Switch library to your real Editor project. By default they land in the project's media bin only; pass place: true to also lay each one at the end of its track (the same as …
List the named editor workflows your Switch Editor agent can run by id: for each, the one sentence a person types, what it needs, whether it quotes first, and how to run it on your project through run…
Tell your Switch Editor agent to build or revise the persistent editable project. It can author scenes, layers, variables, files, motion, and narration plans through the real HyperFrames project works…
Read progress, checks, exact approval quote, revision, and render result for one of your Switch Editor agent runs. A finished render carries renderChecks (black gaps, blank screens, frozen stretches, …
Explicitly approve the exact paid quote currently waiting on one of your Editor runs. Requires approved=true and the matching quote_id; stale or changed projects fail closed.
Safely cancel one of your queued, running, or approval-waiting Switch Editor runs without applying a pending revision.
Render your current persistent Switch Editor project as an MP4 through the Switch render service. Use get_editor_run to follow it to playback and download; the finished render carries renderChecks (bl…
Capture a fixed state of the real current production Switch Editor into your Editor project. The default state is an honest baseline capture of the full Editor, its sections, scroll pages, and rendere…
Keep your list of the questions you asked the creator and are still waiting on. Free. action "ask": record every question you are about to ask (questions: a list of { question, topic, choices? }; topi…
Save your brand kit, or change one you already have: the brand's name, its colors, its fonts, light or dark as the usual look, a few words on how the brand sounds, a folder in your library, and its lo…
Read your brand kit before you design, animate or write anything for your brand: its colors with their roles, its fonts (with a link to the font file when one was uploaded), light or dark as the usual…
List your brand kits: each one with its name, whether it is your default, light or dark, its colors and fonts, and how many logos and pictures it holds. Use get_brand_kit to open one. Free and read on…
Remove one of your own brand kits for good. The logos and pictures it used stay in your library. Call it first without confirm: it says which kit would be removed and changes nothing. Then, once the p…
Move your own pictures from your Switch library to the trash, where they can be brought back. Call it first without confirm: it lists exactly what would be removed and changes nothing. Then, once the …
Remove your own finished videos from your Switch video list and the Video page. Call it first without confirm: it lists exactly what would be removed and changes nothing. Then, once the person agrees,…
Remove one of your own layers projects. The picture it came from and any picture you flattened from it stay in your library. Call it first without confirm: it says exactly what would be removed and ch…
Remove your own audio takes (speech, dialogue, music, sound effects) from your Switch library for good; there is no trash for audio. Call it first without confirm: it lists exactly what would be remov…
Kept for apps that already use it; new work uses upload_reference_asset. Same checks either way: a picture of a real person's face is protected automatically when it is used. Upload one image into you…
Create a new folder in your Switch library. Optional parentId (a top-level folder id) to put it inside one. Free.
Rename one of your folders (its id from list_my_folders). Only your own folders. Free.
Delete one of your folders for good. The first call without confirm:true only says what would happen; nothing changes until confirm is true. What is in it stays in your library, or with cascade:true g…
Resources · 1
Inline gallery and player for Switch images and videos.
ui://widget/switch-media-v6.html
Prompts · 4
Build an interactive artifact, dashboard or page in your brand.
Add motion to an artifact or picture you already have.
A walkthrough of how a product or artifact works, made from real screens.
A scripted video with motion graphics, and a presenter if you want one.
How to use
Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://mcp.switchapp.ai/mcp
Cursor or Cline: add to your MCP config:
{
"mcpServers": {
"ai.switchapp/switch": {
"url": "https://mcp.switchapp.ai/mcp",
"transport": "streamable-http"
}
}
}