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

## Set it up in your app

### Claude

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
```

### Claude Code

Run this in a terminal, then type /mcp inside Claude Code and pick the server to sign in.

```
claude mcp add --transport http genjutsu https://genjutsu.live/mcp
```

### ChatGPT

In ChatGPT, turn on developer mode under Settings → Apps & Connectors → Advanced, then Create a connector with this URL and OAuth sign-in.

```
https://genjutsu.live/mcp
```

### Codex

Add these lines to ~/.codex/config.toml, then run codex mcp login with the server name to sign in.

```
[mcp_servers.genjutsu]
url = "https://genjutsu.live/mcp"
```

### Cursor

Put this in ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Cursor shows a Login button next to the server under Settings → MCP.

```
{
  "mcpServers": {
    "genjutsu": {
      "url": "https://genjutsu.live/mcp"
    }
  }
}
```

### VS Code

Put this in .vscode/mcp.json. Press Start above the server entry; VS Code opens the sign-in page in your browser.

```
{
  "servers": {
    "genjutsu": {
      "type": "http",
      "url": "https://genjutsu.live/mcp"
    }
  }
}
```

### Windsurf

Put this in ~/.codeium/windsurf/mcp_config.json, then refresh the MCP list in Cascade and sign in when asked.

```
{
  "mcpServers": {
    "genjutsu": {
      "serverUrl": "https://genjutsu.live/mcp"
    }
  }
}
```

## The eight tools

- `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.

## 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.

## 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.


---

Source: https://genjutsu.live/mcp-server · Site index for AI agents: https://genjutsu.live/llms.txt · Full content: https://genjutsu.live/llms-full.txt
