CLI and MCP

Every studio in your terminal and in your AI assistant.

The yesilcam-studios package brings two tools: the yesilcam command for scripts and pipelines, and the yesilcam-mcp server for Claude, Cursor and other MCP-compatible assistants. Film, image, animation, design, website, fashion, Maket and AI Influencer studios; same account, same credit balance.

Start in three steps

Install the package

Node 18 or newer: npm install -g yesilcam-studios.

Create an API key

In the app, go to Account → Developer, create a key and paste it once with yesilcam login.

Connect your assistant

Add the yesilcam-mcp server to Claude Code, Claude Desktop, Cursor or any MCP client. No secret goes into the configuration.

Install

Install

Published on npm; the package file on this site remains as a fallback. Your key is stored on your computer in a file only you can read, and is never printed.

Keep your key private. If you lose it, revoke it in the app and create a new one.

npm install -g yesilcam-studios
# Create an API key: https://yesilcamstudios.com/app/account/developer
yesilcam login
yesilcam account show
yesilcam --help

# fallback
npm install -g https://yesilcamstudios.com/downloads/yesilcam-studios.tgz

MCP

Connect your assistant

The server uses the key saved by yesilcam login, so the configurations below contain no secret. On a server or in CI, pass the key with the YESILCAM_API_KEY environment variable.

Fewer tools, a faster assistant · Load only the studios you use: --studios image,film,influencer. Read-only: --read-only. Available studios: image, film, animation, cinema, design, website, fashion, maket, influencer.

Claude Code

claude mcp add yesilcam -- yesilcam-mcp
claude mcp add yesilcam -- yesilcam-mcp --studios image,film,influencer

Claude Desktop (claude_desktop_config.json) · Cursor (~/.cursor/mcp.json) · VS Code, Windsurf and other MCP clients

{
  "mcpServers": {
    "yesilcam": {
      "command": "yesilcam-mcp",
      "args": []
    }
  }
}

Without a global install: "command": "npx", "args": ["-y", "-p", "yesilcam-studios", "yesilcam-mcp"]

Ask your assistant

Ask your assistant

The assistant picks the right tool, shows the price first, creates after you approve, then waits for the result and downloads it.

  • “Make a draft 16:9 image of a lighthouse at sunset by the sea. Tell me the price first, then save it to my desktop.”
  • “Copy a finance influencer from Discover, set the voice to English and make a 10-second talking video about saving on coffee.”
  • “Plan a 60-second long video on “three tips for better phone photos”, show me the storyboard and the total quote, and ask me before producing it.”
  • “Design an A3 retro poster for a jazz night with the texts “Jazz Night” and “Friday 21:00”, and export a print-ready PDF.”
  • “Add this DXF floor plan to a new Maket project and give me the 3D viewer link.”
  • “List the last three videos in my library, download the newest one and show which job it came from.”

Command line examples

Command line examples

The command line shows the price in credits and asks before charging; in scripts approve with --yes and set a ceiling with --max-credits.

# Image Studio: quote first, then create and download
yesilcam image "a lighthouse at dusk, 35mm film" --tier draft --quote
yesilcam image "a lighthouse at dusk, 35mm film" --tier draft --yes --out lighthouse.png

# AI Influencer: copy from Discover, then a 5 s scene with a voice-over
yesilcam discover copy arjun --yes
yesilcam influencer video --mode scene --influencer-id 70 \
  --prompt "raises his coffee cup on a sunny terrace" \
  --speech-lines '[{"text":"Coffee first, budgets later."}]' --yes --wait

# Long video: plan, review the quote, produce later
yesilcam longvideo plan --influencer-id 70 --topic "3 tips for better phone photos" --seconds 60 --yes --wait
yesilcam longvideo produce 16 --quote

# Film Studio › Talk Edit: your talking video (MP4/MOV up to 2 GB), edited with Sam
yesilcam talkedit create talk.mp4 --consent --style preset:bold
yesilcam talkedit analyze 12 --yes --wait && yesilcam talkedit plan 12 --yes --wait
yesilcam talkedit command 12 --text "make the captions yellow" --quote
yesilcam talkedit render 12 --yes --out talk.mp4

# Film Studio › Step-In Scene: storyboard to approve, then shoot
yesilcam stepin storyboard 21 --yes --wait
yesilcam stepin approve 21 --all && yesilcam stepin produce 21 --yes --out episode.mp4

# Gift code: free credits, no confirmation needed
yesilcam redeem HEDIYE-AB12

# Animation Studio (incl. Glyphmation: image to stable ASCII film), Design Studio, Maket
yesilcam animation create "a boatman crosses a misty river" --style inkland --tier professional --yes --wait
yesilcam glyph create "she raises her hand, then returns to the start" --image-path portrait.jpg --formats html --yes --out portrait.mp4
yesilcam glyph render 41 --cols 120 --color amber --charset blocks --yes --wait
yesilcam glyph render --video-asset-id 900 --start 12 --dur 8 --quote   # a part of a longer video
yesilcam design generate "jazz night poster" --preset a3 --style retro --quality draft --yes --wait
yesilcam design export 25 --format pdf --cmyk --pdfx x4 --yes --out poster.pdf
yesilcam maket save ground.dxf --new-project "Villa" --floor 0

# Any job or project
yesilcam wait influencer_job 2093 --save-to ./out
yesilcam --json library list --limit 5

Tools and commands, studio by studio · 172 tools · Package version 0.7.0

Tools and commands, studio by studio

Every MCP tool has an identical CLI command. Tools that spend credits are marked; all of them return a quote first.

Account, library and jobs18 tools

Balance, plan, prices, gift codes (free credits), library (upload, download, share requests), jobs, waiting and progress.

  • yesilcam_accountyesilcam account show
  • yesilcam_balanceyesilcam account balance
  • yesilcam_pricingyesilcam account pricing
  • yesilcam_priceyesilcam account price
  • yesilcam_transactionsyesilcam account transactions
  • yesilcam_redeemyesilcam account redeem
  • yesilcam_statusyesilcam wait status
  • yesilcam_waityesilcam wait until
  • yesilcam_downloadyesilcam library download
  • yesilcam_jobs_listyesilcam jobs list
  • yesilcam_job_statusyesilcam jobs status
  • yesilcam_library_listyesilcam library list
  • yesilcam_library_uploadyesilcam library upload
  • yesilcam_library_renameyesilcam library rename
  • yesilcam_library_deleteyesilcam library delete
  • yesilcam_shareyesilcam library share
  • yesilcam_share_noticesyesilcam library notices
  • yesilcam_lineageyesilcam library lineage
Image Studio1 tools

Generate an image or edit one with a sentence, with your characters and reference images.

  • yesilcam_image_createyesilcam image createcredits
Film Studio52 tools

Video from text and from images, video restyling, character videos, lip sync, characters and Bible, Story to Film and Flow; Talk Edit (edit your talking video with Sam: transcript, captions, cards, commands, render; up to 2 GB) and Step-In Scene (series, episodes, approved storyboard, shooting).

  • yesilcam_video_createyesilcam video createcredits
  • yesilcam_character_video_createyesilcam video characterscredits
  • yesilcam_first_frameyesilcam video first-framecredits
  • yesilcam_lipsync_createyesilcam video lipsynccredits
  • yesilcam_voices_listyesilcam voices list
  • yesilcam_characters_listyesilcam characters list
  • yesilcam_character_createyesilcam characters create
  • yesilcam_character_deleteyesilcam characters delete
  • yesilcam_bible_createyesilcam characters biblecredits
  • yesilcam_bible_getyesilcam characters bible-get
  • yesilcam_prompt_improveyesilcam prompt improvecredits
  • yesilcam_story_film_createyesilcam film storycredits
  • yesilcam_flow_createyesilcam film flowcredits
  • yesilcam_flow_listyesilcam film list
  • yesilcam_flow_getyesilcam film get
  • yesilcam_flow_scene_updateyesilcam film scene
  • yesilcam_flow_produceyesilcam film producecredits
  • yesilcam_flow_controlyesilcam film control
  • yesilcam_talkedit_configyesilcam talkedit config
  • yesilcam_talkedit_listyesilcam talkedit list
  • yesilcam_talkedit_createyesilcam talkedit create
  • yesilcam_talkedit_analyzeyesilcam talkedit analyzecredits
  • yesilcam_talkedit_planyesilcam talkedit plancredits
  • yesilcam_talkedit_commandyesilcam talkedit commandcredits
  • yesilcam_talkedit_imagesyesilcam talkedit imagescredits
  • yesilcam_talkedit_renderyesilcam talkedit rendercredits
  • yesilcam_talkedit_statusyesilcam talkedit status
  • yesilcam_talkedit_undoyesilcam talkedit undo
  • yesilcam_talkedit_downloadyesilcam talkedit download
  • yesilcam_talkedit_deleteyesilcam talkedit delete
  • yesilcam_talkedit_stylesyesilcam talkedit styles
  • yesilcam_talkedit_style_saveyesilcam talkedit style-save
  • yesilcam_talkedit_style_deleteyesilcam talkedit style-delete
  • yesilcam_stepin_configyesilcam stepin config
  • yesilcam_stepin_series_listyesilcam stepin series
  • yesilcam_stepin_series_getyesilcam stepin series-get
  • yesilcam_stepin_series_saveyesilcam stepin series-save
  • yesilcam_stepin_series_deleteyesilcam stepin series-delete
  • yesilcam_stepin_castyesilcam stepin cast
  • yesilcam_stepin_kitsyesilcam stepin kits
  • yesilcam_stepin_episode_createyesilcam stepin episode-create
  • yesilcam_stepin_episode_getyesilcam stepin episode
  • yesilcam_stepin_episode_saveyesilcam stepin episode-save
  • yesilcam_stepin_episode_deleteyesilcam stepin episode-delete
  • yesilcam_stepin_storyboardyesilcam stepin storyboardcredits
  • yesilcam_stepin_approveyesilcam stepin approve
  • yesilcam_stepin_panel_edityesilcam stepin panel-edit
  • yesilcam_stepin_reviseyesilcam stepin revisecredits
  • yesilcam_stepin_produceyesilcam stepin producecredits
  • yesilcam_stepin_retakeyesilcam stepin retakecredits
  • yesilcam_stepin_reassembleyesilcam stepin reassemblecredits
  • yesilcam_stepin_downloadyesilcam stepin download
Animation Studio20 tools

26 animation styles, Ink Landscape, Inkmation, Custom (animate your own image along a camera path) and Glyphmation (your image as a stable ASCII film; Standard, Blocks or Letters only character set; MP4, GIF, HTML); MP4, WebP and GIF output.

  • yesilcam_animation_stylesyesilcam animation stylesfree, local
  • yesilcam_animation_voicesyesilcam animation voices
  • yesilcam_animation_createyesilcam animation createcredits
  • yesilcam_animation_storyyesilcam animation storycredits
  • yesilcam_animation_listyesilcam animation list
  • yesilcam_animation_getyesilcam animation get
  • yesilcam_animation_renderyesilcam animation rendercredits
  • yesilcam_animation_shareyesilcam animation share
  • yesilcam_custom_animation_createyesilcam animation customcredits
  • yesilcam_custom_animation_listyesilcam animation custom-list
  • yesilcam_inkmation_createyesilcam inkmation createcredits
  • yesilcam_inkmation_listyesilcam inkmation list
  • yesilcam_inkmation_getyesilcam inkmation get
  • yesilcam_inkmation_renderyesilcam inkmation rendercredits
  • yesilcam_glyph_quoteyesilcam glyph quote
  • yesilcam_glyph_createyesilcam glyph createcredits
  • yesilcam_glyph_renderyesilcam glyph rendercredits
  • yesilcam_glyph_getyesilcam glyph get
  • yesilcam_glyph_listyesilcam glyph list
  • yesilcam_glyph_improveyesilcam glyph improvecredits
Cinema Studio6 tools

Timeline export up to 4K, narration, a talking presenter and automatic subtitles.

  • yesilcam_cinema_projectsyesilcam cinema list
  • yesilcam_cinema_renderyesilcam cinema rendercredits
  • yesilcam_cinema_voicesyesilcam cinema voices
  • yesilcam_cinema_narrateyesilcam cinema narratecredits
  • yesilcam_cinema_presenteryesilcam cinema presentercredits
  • yesilcam_cinema_subtitlesyesilcam cinema subtitlescredits
Design Studio6 tools

Posters, business cards, brochures and social posts; PNG, CMYK PDF/X, SVG and EPS export.

  • yesilcam_design_presetsyesilcam design presetsfree, local
  • yesilcam_design_projectsyesilcam design projects
  • yesilcam_design_listyesilcam design list
  • yesilcam_design_generateyesilcam design generatecredits
  • yesilcam_design_getyesilcam design get
  • yesilcam_design_exportyesilcam design exportcredits
Website Studio · Website Promo · Assemble / Disassemble17 tools

Videos that take a product apart and put it back together, a scrolling landing page from that video, and a narrated promo film of a website.

  • yesilcam_assemble_createyesilcam assemble createcredits
  • yesilcam_assemble_listyesilcam assemble list
  • yesilcam_assemble_getyesilcam assemble get
  • yesilcam_assemble_regenerateyesilcam assemble regeneratecredits
  • yesilcam_assemble_deleteyesilcam assemble delete
  • yesilcam_photo_enhanceyesilcam assemble enhancecredits
  • yesilcam_website_createyesilcam website createcredits
  • yesilcam_website_listyesilcam website list
  • yesilcam_website_getyesilcam website get
  • yesilcam_website_updateyesilcam website update
  • yesilcam_website_manageyesilcam website manage
  • yesilcam_promo_createyesilcam promo createcredits
  • yesilcam_promo_listyesilcam promo list
  • yesilcam_promo_getyesilcam promo get
  • yesilcam_promo_script_saveyesilcam promo script
  • yesilcam_promo_produceyesilcam promo producecredits
  • yesilcam_promo_deleteyesilcam promo delete
Fashion Try-On7 tools

Dress a model, your character or a photo in your garments; outfits, body types, a stylist and fashion films.

  • yesilcam_tryonyesilcam fashion tryoncredits
  • yesilcam_body_variantyesilcam fashion bodycredits
  • yesilcam_stylistyesilcam fashion stylistcredits
  • yesilcam_fashion_filmyesilcam fashion filmcredits
  • yesilcam_wardrobeyesilcam fashion wardrobe
  • yesilcam_garment_from_urlyesilcam fashion import
  • yesilcam_fashion_modelsyesilcam fashion models
Maket9 tools

Analyze a DXF/JSON plan locally for free, add it to a project, get a plan from a photo and a photoreal render from a 3D view.

  • yesilcam_maket_analyzeyesilcam maket analyzefree, local
  • yesilcam_maket_projectsyesilcam maket projects
  • yesilcam_maket_create_projectyesilcam maket create
  • yesilcam_maket_plansyesilcam maket plans
  • yesilcam_maket_saveyesilcam maket save
  • yesilcam_maket_getyesilcam maket get
  • yesilcam_maket_deleteyesilcam maket delete
  • yesilcam_maket_image_to_planyesilcam maket from-imagecredits
  • yesilcam_maket_renderyesilcam maket rendercredits
AI Influencer Studio36 tools

Create influencers (with Sam or from your own photo), voice and language, scenes with 1-3 characters, recreate, talking videos, Discover, long videos from 15 s to 10 min and automations.

  • yesilcam_influencer_configyesilcam influencer config
  • yesilcam_influencer_defineyesilcam influencer definecredits
  • yesilcam_influencer_createyesilcam influencer createcredits
  • yesilcam_influencer_listyesilcam influencer list
  • yesilcam_influencer_getyesilcam influencer get
  • yesilcam_influencer_updateyesilcam influencer update
  • yesilcam_influencer_deleteyesilcam influencer delete
  • yesilcam_influencer_voicesyesilcam influencer voices
  • yesilcam_influencer_voice_setyesilcam influencer voice-set
  • yesilcam_influencer_talk_assistyesilcam influencer writecredits
  • yesilcam_influencer_templatesyesilcam influencer templates
  • yesilcam_influencer_videoyesilcam influencer videocredits
  • yesilcam_influencer_jobsyesilcam influencer jobs
  • yesilcam_discoveryesilcam discover feed
  • yesilcam_discover_copyyesilcam discover copycredits
  • yesilcam_longvideo_listyesilcam longvideo list
  • yesilcam_longvideo_getyesilcam longvideo get
  • yesilcam_longvideo_assistyesilcam longvideo scriptcredits
  • yesilcam_longvideo_planyesilcam longvideo plancredits
  • yesilcam_longvideo_saveyesilcam longvideo save
  • yesilcam_longvideo_framesyesilcam longvideo framescredits
  • yesilcam_longvideo_produceyesilcam longvideo producecredits
  • yesilcam_longvideo_resumeyesilcam longvideo resumecredits
  • yesilcam_longvideo_regen_shotyesilcam longvideo regencredits
  • yesilcam_longvideo_controlyesilcam longvideo control
  • yesilcam_automation_estimateyesilcam automation estimate
  • yesilcam_automation_saveyesilcam automation savecredits
  • yesilcam_automation_listyesilcam automation list
  • yesilcam_automation_getyesilcam automation get
  • yesilcam_automation_controlyesilcam automation control
  • yesilcam_automation_run_nowyesilcam automation run-nowcredits
  • yesilcam_automation_reviewyesilcam automation reviewcredits
  • yesilcam_automation_runyesilcam automation run
  • yesilcam_social_statusyesilcam social status
  • yesilcam_social_publishyesilcam social publishcredits
  • yesilcam_social_postsyesilcam social posts

Credits and approval

  • Every tool that spends credits returns a quote first and charges nothing. Your assistant shows you the price and calls again with confirm=true only after you agree.
  • The command line shows the price in credits and asks before charging; in scripts approve with --yes and set a ceiling with --max-credits.
  • Prices are the same as in the app and failed jobs are refunded automatically. Long videos are charged chapter by chapter; automations never exceed their monthly cap.

Security

  • Keys are read-only or read-and-create, can expire, and can be revoked instantly in the app.
  • A key cannot delete the account, change the password or email, make payments, create new keys or connect social accounts.
  • The server keeps only a secure fingerprint of the key, never the key itself; on your computer it lives in a file only you can read.
  • Your media is private and links are signed and expire. Public links and The Wall go through a share request.
  • Characters are always adults and real public figures cannot be used. Your own photo or video is used only with explicit consent and after a safety check.

Create your key and let your assistant create.

It takes a few seconds in Account → Developer.

Create an API key