---
title: Run MCP
description: Connect Claude Code, Cursor, Codex or any Streamable HTTP client to the NOLGIA MCP server and generate from inside the conversation.
---

# Run MCP

Connect to `https://mcp.nolgia.ai/mcp` over Streamable HTTP and authenticate with `Authorization: Bearer nol_...`, using your Personal Access Token.

## Connect

Replace `nol_your_token_here` with your token.

```bash tab="Claude Code"
$ claude mcp add --transport http nolgia https://mcp.nolgia.ai/mcp --header "Authorization: Bearer nol_your_token_here"
```

```json tab="Cursor" title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "nolgia": {
      "url": "https://mcp.nolgia.ai/mcp",
      "headers": {
        "Authorization": "Bearer nol_your_token_here"
      }
    }
  }
}
```

```bash tab="Codex"
$ codex mcp add nolgia --url https://mcp.nolgia.ai/mcp
```

```text tab="Any client"
https://mcp.nolgia.ai/mcp
Authorization: Bearer nol_your_token_here
```

For Codex, set the bearer header under that server in `~/.codex/config.toml`; `codex mcp add --help` lists the available options.

## The tools

<!-- gen:mcp-tools -->
The server registry has 72 tools in eight groups.

#### Generate

| Tool | What it does |
| --- | --- |
| `nolgia_text_to_image` | Generate image from text |
| `nolgia_image_to_image` | Generate image from an image |
| `nolgia_text_to_video` | Generate video from text |
| `nolgia_image_to_video` | Animate an image into video |
| `nolgia_text_to_audio` | Generate audio from text |
| `nolgia_run_preset` | Run a preset |
| `nolgia_render_blocks` | Assemble clips and narration into one video |
| `nolgia_multicam_plan` | Plan a Multicam job |
| `nolgia_multicam_start` | Start a Multicam job |
| `nolgia_multicam_run` | Check a Multicam job |
| `nolgia_multicam_download` | Download every Multicam angle |
| `nolgia_multicam_cancel` | Stop a Multicam job |
| `nolgia_generate_3d` | Generate a 3D model |
| `nolgia_generate_set` | Generate a set of images |
| `nolgia_miroge_options` | Price a Miroge remake |
| `nolgia_miroge` | Remake a clip with Miroge |

#### Your library

| Tool | What it does |
| --- | --- |
| `nolgia_list_assets` | List generated assets |
| `nolgia_get_asset` | Open an asset |
| `nolgia_delete_asset` | Trash an asset |
| `nolgia_update_asset_tags` | Set an asset's tags |
| `nolgia_upload_asset` | Upload an image |
| `nolgia_list_characters` | List saved characters |
| `nolgia_get_character` | Get one character |
| `nolgia_create_character` | Save a character |
| `nolgia_update_character` | Update a character |
| `nolgia_delete_character` | Delete a character |
| `nolgia_list_styles` | List saved styles |
| `nolgia_create_style` | Save a style |
| `nolgia_delete_style` | Delete a saved style |
| `nolgia_transcribe_asset` | Transcribe an asset |
| `nolgia_get_transcript` | Get an asset transcript |
| `nolgia_suggest_clips` | Find short video clips |
| `nolgia_create_clips` | Create short video clips |
| `nolgia_get_set` | Get a set of images |
| `nolgia_get_miroge` | Check a Miroge remake |

#### Projects

| Tool | What it does |
| --- | --- |
| `nolgia_list_projects` | List projects |
| `nolgia_get_project` | Get one project |
| `nolgia_create_project` | Create a project |
| `nolgia_update_project` | Update a project |
| `nolgia_delete_project` | Delete a project |
| `nolgia_add_project_assets` | Add assets to a project |
| `nolgia_remove_project_asset` | Remove an asset from a project |
| `nolgia_list_canvases` | List canvases |
| `nolgia_get_canvas` | Get a canvas |
| `nolgia_create_canvas` | Create a canvas |
| `nolgia_update_canvas` | Update a canvas |

#### Edit sessions and tweaks

| Tool | What it does |
| --- | --- |
| `nolgia_list_tweak_scopes` | List image tweak scopes |
| `nolgia_create_edit_session` | Start an edit session |
| `nolgia_get_edit_session` | Read an edit session |
| `nolgia_edit_session_step` | Apply the next image edit |
| `nolgia_revert_edit_session` | Revert an edit session |
| `nolgia_estimate_edit_session` | Estimate the next edit |

#### Presets

| Tool | What it does |
| --- | --- |
| `nolgia_list_presets` | List presets |
| `nolgia_get_preset` | Get one preset |

#### Timelines

| Tool | What it does |
| --- | --- |
| `nolgia_validate_mask` | Validate a timeline mask |
| `nolgia_validate_motion` | Validate timeline motion |
| `nolgia_list_color_presets` | List color-grade presets |
| `nolgia_get_render` | Check a render |

#### Desktop apps

| Tool | What it does |
| --- | --- |
| `nolgia_app_status` | List connected desktop apps |
| `nolgia_app_info` | Read a desktop app's state |
| `nolgia_app_run` | Run code in a desktop app |
| `nolgia_app_command` | Check a desktop app command |
| `nolgia_app_preview` | Preview a desktop app's document |
| `nolgia_app_import` | Import an asset into a desktop app |
| `nolgia_app_export` | Export from a desktop app |
| `nolgia_app_save` | Save the document in a desktop app |
| `nolgia_app_open` | Open a document in a desktop app |

#### Models, account and jobs

| Tool | What it does |
| --- | --- |
| `nolgia_list_models` | List models |
| `nolgia_get_account` | Get the signed-in account |
| `nolgia_get_usage` | Get generation counts |
| `nolgia_cancel_job` | Cancel a generation job |
| `nolgia_list_jobs` | List generation jobs |
<!-- /gen -->

## Prompts

The server also offers prompts. Every public Film assistant preset, a preset that runs in a desktop app on your computer such as Blender, is a prompt named by its slug with one optional argument, `brief`. Getting one returns a single message: the preset's starter prompt, your brief, then the workflow your agent follows in the app. Running it is free; anything it makes with NOLGIA is priced as usual. In Claude Code they appear as `/mcp__nolgia__<slug>`, with the preset's slug, such as `blender-destruction`, at the end.

## What to expect

> [!NOTE]
> ChatGPT and Claude desktop/web need OAuth sign-in rather than a bearer header; sign-in is live, but their setup instructions are [not published yet](https://nolgia.ai/mcp).

:::cards
- [Get your API key](./authentication.html) icon=spot-keys: Create the token your MCP client sends.
- [Nolgia for Claude Code, Cursor and Codex](./coding-agents.html) icon=spot-agent: Install skills and the agent runbook.
- [The CLI](./cli.html) icon=spot-terminal: Generate and manage media from your terminal.
:::