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 showyesilcam_balanceyesilcam account balanceyesilcam_pricingyesilcam account pricingyesilcam_priceyesilcam account priceyesilcam_transactionsyesilcam account transactionsyesilcam_redeemyesilcam account redeemyesilcam_statusyesilcam wait statusyesilcam_waityesilcam wait untilyesilcam_downloadyesilcam library downloadyesilcam_jobs_listyesilcam jobs listyesilcam_job_statusyesilcam jobs statusyesilcam_library_listyesilcam library listyesilcam_library_uploadyesilcam library uploadyesilcam_library_renameyesilcam library renameyesilcam_library_deleteyesilcam library deleteyesilcam_shareyesilcam library shareyesilcam_share_noticesyesilcam library noticesyesilcam_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 createcreditsyesilcam_character_video_createyesilcam video characterscreditsyesilcam_first_frameyesilcam video first-framecreditsyesilcam_lipsync_createyesilcam video lipsynccreditsyesilcam_voices_listyesilcam voices listyesilcam_characters_listyesilcam characters listyesilcam_character_createyesilcam characters createyesilcam_character_deleteyesilcam characters deleteyesilcam_bible_createyesilcam characters biblecreditsyesilcam_bible_getyesilcam characters bible-getyesilcam_prompt_improveyesilcam prompt improvecreditsyesilcam_story_film_createyesilcam film storycreditsyesilcam_flow_createyesilcam film flowcreditsyesilcam_flow_listyesilcam film listyesilcam_flow_getyesilcam film getyesilcam_flow_scene_updateyesilcam film sceneyesilcam_flow_produceyesilcam film producecreditsyesilcam_flow_controlyesilcam film controlyesilcam_talkedit_configyesilcam talkedit configyesilcam_talkedit_listyesilcam talkedit listyesilcam_talkedit_createyesilcam talkedit createyesilcam_talkedit_analyzeyesilcam talkedit analyzecreditsyesilcam_talkedit_planyesilcam talkedit plancreditsyesilcam_talkedit_commandyesilcam talkedit commandcreditsyesilcam_talkedit_imagesyesilcam talkedit imagescreditsyesilcam_talkedit_renderyesilcam talkedit rendercreditsyesilcam_talkedit_statusyesilcam talkedit statusyesilcam_talkedit_undoyesilcam talkedit undoyesilcam_talkedit_downloadyesilcam talkedit downloadyesilcam_talkedit_deleteyesilcam talkedit deleteyesilcam_talkedit_stylesyesilcam talkedit stylesyesilcam_talkedit_style_saveyesilcam talkedit style-saveyesilcam_talkedit_style_deleteyesilcam talkedit style-deleteyesilcam_stepin_configyesilcam stepin configyesilcam_stepin_series_listyesilcam stepin seriesyesilcam_stepin_series_getyesilcam stepin series-getyesilcam_stepin_series_saveyesilcam stepin series-saveyesilcam_stepin_series_deleteyesilcam stepin series-deleteyesilcam_stepin_castyesilcam stepin castyesilcam_stepin_kitsyesilcam stepin kitsyesilcam_stepin_episode_createyesilcam stepin episode-createyesilcam_stepin_episode_getyesilcam stepin episodeyesilcam_stepin_episode_saveyesilcam stepin episode-saveyesilcam_stepin_episode_deleteyesilcam stepin episode-deleteyesilcam_stepin_storyboardyesilcam stepin storyboardcreditsyesilcam_stepin_approveyesilcam stepin approveyesilcam_stepin_panel_edityesilcam stepin panel-edityesilcam_stepin_reviseyesilcam stepin revisecreditsyesilcam_stepin_produceyesilcam stepin producecreditsyesilcam_stepin_retakeyesilcam stepin retakecreditsyesilcam_stepin_reassembleyesilcam stepin reassemblecreditsyesilcam_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, localyesilcam_animation_voicesyesilcam animation voicesyesilcam_animation_createyesilcam animation createcreditsyesilcam_animation_storyyesilcam animation storycreditsyesilcam_animation_listyesilcam animation listyesilcam_animation_getyesilcam animation getyesilcam_animation_renderyesilcam animation rendercreditsyesilcam_animation_shareyesilcam animation shareyesilcam_custom_animation_createyesilcam animation customcreditsyesilcam_custom_animation_listyesilcam animation custom-listyesilcam_inkmation_createyesilcam inkmation createcreditsyesilcam_inkmation_listyesilcam inkmation listyesilcam_inkmation_getyesilcam inkmation getyesilcam_inkmation_renderyesilcam inkmation rendercreditsyesilcam_glyph_quoteyesilcam glyph quoteyesilcam_glyph_createyesilcam glyph createcreditsyesilcam_glyph_renderyesilcam glyph rendercreditsyesilcam_glyph_getyesilcam glyph getyesilcam_glyph_listyesilcam glyph listyesilcam_glyph_improveyesilcam glyph improvecredits
Cinema Studio6 tools
Timeline export up to 4K, narration, a talking presenter and automatic subtitles.
yesilcam_cinema_projectsyesilcam cinema listyesilcam_cinema_renderyesilcam cinema rendercreditsyesilcam_cinema_voicesyesilcam cinema voicesyesilcam_cinema_narrateyesilcam cinema narratecreditsyesilcam_cinema_presenteryesilcam cinema presentercreditsyesilcam_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, localyesilcam_design_projectsyesilcam design projectsyesilcam_design_listyesilcam design listyesilcam_design_generateyesilcam design generatecreditsyesilcam_design_getyesilcam design getyesilcam_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 createcreditsyesilcam_assemble_listyesilcam assemble listyesilcam_assemble_getyesilcam assemble getyesilcam_assemble_regenerateyesilcam assemble regeneratecreditsyesilcam_assemble_deleteyesilcam assemble deleteyesilcam_photo_enhanceyesilcam assemble enhancecreditsyesilcam_website_createyesilcam website createcreditsyesilcam_website_listyesilcam website listyesilcam_website_getyesilcam website getyesilcam_website_updateyesilcam website updateyesilcam_website_manageyesilcam website manageyesilcam_promo_createyesilcam promo createcreditsyesilcam_promo_listyesilcam promo listyesilcam_promo_getyesilcam promo getyesilcam_promo_script_saveyesilcam promo scriptyesilcam_promo_produceyesilcam promo producecreditsyesilcam_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 tryoncreditsyesilcam_body_variantyesilcam fashion bodycreditsyesilcam_stylistyesilcam fashion stylistcreditsyesilcam_fashion_filmyesilcam fashion filmcreditsyesilcam_wardrobeyesilcam fashion wardrobeyesilcam_garment_from_urlyesilcam fashion importyesilcam_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, localyesilcam_maket_projectsyesilcam maket projectsyesilcam_maket_create_projectyesilcam maket createyesilcam_maket_plansyesilcam maket plansyesilcam_maket_saveyesilcam maket saveyesilcam_maket_getyesilcam maket getyesilcam_maket_deleteyesilcam maket deleteyesilcam_maket_image_to_planyesilcam maket from-imagecreditsyesilcam_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 configyesilcam_influencer_defineyesilcam influencer definecreditsyesilcam_influencer_createyesilcam influencer createcreditsyesilcam_influencer_listyesilcam influencer listyesilcam_influencer_getyesilcam influencer getyesilcam_influencer_updateyesilcam influencer updateyesilcam_influencer_deleteyesilcam influencer deleteyesilcam_influencer_voicesyesilcam influencer voicesyesilcam_influencer_voice_setyesilcam influencer voice-setyesilcam_influencer_talk_assistyesilcam influencer writecreditsyesilcam_influencer_templatesyesilcam influencer templatesyesilcam_influencer_videoyesilcam influencer videocreditsyesilcam_influencer_jobsyesilcam influencer jobsyesilcam_discoveryesilcam discover feedyesilcam_discover_copyyesilcam discover copycreditsyesilcam_longvideo_listyesilcam longvideo listyesilcam_longvideo_getyesilcam longvideo getyesilcam_longvideo_assistyesilcam longvideo scriptcreditsyesilcam_longvideo_planyesilcam longvideo plancreditsyesilcam_longvideo_saveyesilcam longvideo saveyesilcam_longvideo_framesyesilcam longvideo framescreditsyesilcam_longvideo_produceyesilcam longvideo producecreditsyesilcam_longvideo_resumeyesilcam longvideo resumecreditsyesilcam_longvideo_regen_shotyesilcam longvideo regencreditsyesilcam_longvideo_controlyesilcam longvideo controlyesilcam_automation_estimateyesilcam automation estimateyesilcam_automation_saveyesilcam automation savecreditsyesilcam_automation_listyesilcam automation listyesilcam_automation_getyesilcam automation getyesilcam_automation_controlyesilcam automation controlyesilcam_automation_run_nowyesilcam automation run-nowcreditsyesilcam_automation_reviewyesilcam automation reviewcreditsyesilcam_automation_runyesilcam automation runyesilcam_social_statusyesilcam social statusyesilcam_social_publishyesilcam social publishcreditsyesilcam_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