Docs / Setting up / Run MCP
Setting up
Language TypeScript Python Rust CLI HTTP (curl)
On this page
Connect The tools Prompts What to expect
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.
Claude Code Cursor Codex Any client
shell Copy $ claude mcp add --transport http nolgia https://mcp.nolgia.ai/mcp --header "Authorization: Bearer nol_your_token_here"
JSON ~/.cursor/mcp.json Copy {
"mcpServers" : {
"nolgia" : {
"url" : "https://mcp.nolgia.ai/mcp" ,
"headers" : {
"Authorization" : "Bearer nol_your_token_here"
}
}
}
}
shell Copy $ codex mcp add nolgia --url https://mcp.nolgia.ai/mcp
text Copy 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 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
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 .
Lock
Get your API key Create the token your MCP client sends.
→
Agent core with orbiting tasks
Nolgia for Claude Code, Cursor and Codex Install skills and the agent runbook.
→
Terminal window
The CLI Generate and manage media from your terminal.
→
← Get your API key Nolgia for Claude Code, Cursor and Codex →