Genjutsu

For AI assistants and editors

The Genjutsu MCP server

Add one URL to your AI app and it can run effects and start renders on your Genjutsu credits, check on them and fetch the files. Prices match the web studio to the credit.

Server URL

https://genjutsu.live/mcp

What happens when you connect

  1. 1Your app opens a Genjutsu sign-in window. Use the account whose credits you want to spend.
  2. 2A consent screen names the app and lists what it can do. Nothing is shared until you press Allow.
  3. 3The app gets a token that lasts one hour and renews itself for up to 30 days of use.
  4. 4Credits are taken when a render starts and returned if it fails. Disconnect the app any time in Settings.

Set it up in your app

In Claude (web or desktop), open Settings → Connectors → Add custom connector. Paste the URL, press Add, then Connect and sign in. Custom connectors need a paid Claude plan.

https://genjutsu.live/mcp

The eight tools

Your assistant picks the tool; you describe the clip or image in plain words.

list_modelsLists every video and image model with its lengths, sizes and credit rates.
generate_videoStarts a text-to-video or photo-to-video render. From 24 credits.
generate_imageStarts an image render or edit, with up to the model’s limit of reference pictures. From 6 credits.
list_effectsLists every Genjutsu effect with its model, the inputs it needs and its credits per second.
apply_effectRuns an effect on a clip you link to (MP4 or MOV, 3 to 30 s), from 13 credits per second. It asks you to confirm your rights to the people shown first.
get_taskChecks one render and returns the file link when it is ready.
list_tasksLists your recent renders, newest first.
get_creditsReturns your credit balance.

apply_effect needs a direct link to the clip file (a share page will not work), and the same rights check as the studio. For drag-and-drop uploads and the before/after slider, use the web studio. Open the studio

Use an API key from scripts

Tools that cannot open a browser can send an API key instead of signing in. Create one under Settings → API keys and send it as a Bearer header. Keys need a plan that includes API access; OAuth sign-in works on every account.

{
  "url": "https://genjutsu.live/mcp",
  "headers": { "Authorization": "Bearer sk_…" }
}
Create an API key

If something goes wrong

The sign-in window never opens
Your app may have cached an old connection. Remove the server, add it again with the exact URL above (it ends in /mcp) and reconnect.
401 or "unauthorized" after it worked
The token was revoked or unused for 30 days. Reconnect from your app; you will see the consent screen again.
"Not enough credits"
The render was not started and nothing was charged. Top up on the pricing page, or ask for a shorter clip or lower resolution.
A render stays "processing"
Most videos take 1 to 4 minutes. Ask your assistant to call get_task again; failed renders refund their credits by themselves.

Questions

Does the Genjutsu MCP server cost extra?

No. You pay the same credits per render as in the web studio, and nothing for the connection itself.

Which account do the renders go to?

The one you signed in with in the consent window. Renders show up in My videos next to the ones you made on the site.

Can two apps share one Genjutsu account?

Yes. Each app gets its own consent and its own token, and you can disconnect them one by one.

Are renders made through MCP public?

They follow your account’s setting. With Private Mode on (any credit pack, Pro, Ultimate or a team plan), they stay out of the public gallery.

What does Genjutsu store about the connection?

The app’s name and redirect address, its access tokens and the time it was last used. Prompts are stored with your renders, as on the site.