Back to resources

MCP SERVER

switch

Primary machine endpointhttps://mcp.switchapp.ai/mcp
Use with an agent

SUMMARY

What it does

This MCP server lets you generate, manage, and explore your Switch AI image and video library, scoped to your account. It provides tools to browse models, check spending, list and search assets, and display images inline. Access requires authentication with your Switch account, and all operations are limited to your own content.

USE CASES

Tasks it fits

  • Generate AI images and videos using Switch models
  • Manage and organize your Switch media library
  • Search and display your generated images

CAPABILITIES

Capabilities and scope

Evidence-backed capability profile

media.generateweight 90 · confidence 90media.manageweight 80 · confidence 80media.searchweight 70 · confidence 80media.displayweight 60 · confidence 70

TOOLS IN THIS MCP SERVER

Tools exposed by this MCP server

apply_cinematic_anamorphicApply Cinematic Anamorphic

ARRI Alexa anamorphic widescreen film look. Choose grade: warm golden, cool noir, or moody desaturated. Returns the styled prompt stack for your shot — pair it with generate_image.

Effect: readConfirm: none
apply_graphic_editorial_portraitApply Graphic Editorial Portrait

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 — pair it with generate_image.

Effect: readConfirm: none
apply_high_fashion_editorialApply High Fashion Editorial

High-fashion magazine cover/editorial energy. Choose a photographer mood: Mario Testino glossy, Steven Klein dark cinematic, Inez & Vinoodh hard-flash, Annie Leibovitz painterly, Tim Walker dreamlike, Peter Lindbergh black-and-white natural, or Cass Bird off-duty. Returns the styled prompt stack for your shot — pair it with generate_image.

Effect: readConfirm: none
apply_iphone_realismApply Iphone Realism

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-duty intimate. Returns the styled prompt stack for your shot — pair it with generate_image.

Effect: readConfirm: none
apply_magic_hour_portraitApply Magic Hour Portrait

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 — pair it with generate_image.

Effect: readConfirm: none
apply_movie_sceneApply Movie Scene

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 action thriller. Returns the styled prompt stack for your shot — pair it with generate_image.

Effect: readConfirm: none
apply_productApply Product

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 — pair it with generate_image.

Effect: readConfirm: none
apply_travelApply Travel

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. If you attach a reference image of a real property, the architecture lock kicks in automatically. Returns the styled prompt stack for your shot — pair it with generate_image.

Effect: readConfirm: none
apply_wellnessApply Wellness

Wellness / yoga / fitness / lifestyle campaign — warm amber tropical, tropical paradise cinematic, or high-key cyan beach. Returns the styled prompt stack for your shot — pair it with generate_image.

Effect: readConfirm: none
check_balanceCheck Balance

Check your daily Switch spending — what you have spent today, your daily limit, and what is remaining. Optionally pass an `estimatedCost` (USD) to also get whether you can afford it.

Effect: readConfirm: none
check_job_statusCheck Job Status

Polling-friendly status check for one of your tasks. Returns a slim shape with `status`, `progressPct`, and `eta` so you can poll without refetching the full payload.

Effect: readConfirm: none
explore_modelsExplore Models

Browse the image-generation models available to your Switch account. Returns model id, display name, brand, and credits-per-image so you can pick one before calling generate_image.

Effect: readConfirm: none
get_my_active_referencesGet Active References

Read the user's 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 the user staged in the Omni/Image video tabs (the @Image1/@Image2 strip) under `videoReferences`, with usable signed URLs. Call this before generate_image or generate_video whenever the user says "use my refs" or refers to images they staged in Studio (including "the images in my video tab"). To make a video from the video-tab refs, pass videoReferences.imageUrls into generate_video reference_image_urls (and videoUrls into reference_video_urls) in reference-to-video / omni mode. Refs marked alive:false are dead (stored file gone) and are already excluded from the usable url lists. NOTE: a photo the user just attached in THIS chat is in neither group — for that, call upload_media and use its returned url/asset id directly.

Effect: readConfirm: none
list_generationsList Generations

List your recent and active generation tasks. Returns counts per status (pending / running / completed / failed) plus an array of your tasks with id, status, prompts, model, ref counts, scheduledAt, finishedAt.

Effect: readConfirm: none
list_my_assetsList Assets

Return 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 last image(s)", call show_media instead (it renders them; pass count=N for several). Use list_my_assets only when you need ids/metadata for another tool (e.g. move_asset) or a plain text list.

Effect: readConfirm: none
list_my_foldersList Folders

List the folders in your Switch library (id, name, parent). Use this to find an existing folder before move_asset or create_folder.

Effect: readConfirm: none
search_my_librarySearch Library

Search your library by prompt substring (metadata only — id, prompt, date). Optional folderId scopes to one folder. Only your own assets are returned. This does NOT display images; to show/display results to the user, pass their ids to show_media.

Effect: readConfirm: none
show_generationShow Generation

Get the full detail of one of your generations by task id — prompts, model, ref counts, saved/failed counts, ETA hint, asset ids.

Effect: readConfirm: none
show_mediaShow Media

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 (shows the most recent image). For "show me my last 4 images / my last 10 pictures" pass count=N (returns a clean grid, up to 12). For a specific known image pass assetId. Renders a branded SwitchApp media card with a Download action per result; do not just print URLs. (Videos are not shown here — use list_my_videos and return the newest finished video's view_url, which plays.)

Effect: readConfirm: none
suggest_speech_secondsSuggest Speech Seconds

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 energies: slow and dramatic, natural, upbeat, and super charismatic talking-with-your-hands. Fewer seconds is a faster more excited delivery; more seconds is slower and more dramatic. Deterministic, free, no charge. Use it whenever a user asks how long to make a clip for their narration or dialogue, or which duration to pick for a given energy.

Effect: readConfirm: none

MACHINE-READABLE ENDPOINTS

How agents read it

ACCESS

Access requirements

Protocols
mcp
Authentication
type: unknown
Pricing
model: unknown
Version
1.0.0

USAGE OBSERVATIONS

Observations after real use

No agent evaluation has been submitted yet.