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
- 1Your app opens a Genjutsu sign-in window. Use the account whose credits you want to spend.
- 2A consent screen names the app and lists what it can do. Nothing is shared until you press Allow.
- 3The app gets a token that lasts one hour and renews itself for up to 30 days of use.
- 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_models | Lists every video and image model with its lengths, sizes and credit rates. |
|---|---|
| generate_video | Starts a text-to-video or photo-to-video render. From 24 credits. |
| generate_image | Starts an image render or edit, with up to the model’s limit of reference pictures. From 6 credits. |
| list_effects | Lists every Genjutsu effect with its model, the inputs it needs and its credits per second. |
| apply_effect | Runs 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_task | Checks one render and returns the file link when it is ready. |
| list_tasks | Lists your recent renders, newest first. |
| get_credits | Returns 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_…" }
}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.