Neonix MCP — Motion infrastructure for AI agents

A standard bridge between an AI client and Neonix.

What is MCP?

Model Context Protocol lets a compatible AI client discover structured tools and call them with validated inputs. Instead of asking an agent to print a large JSON file in chat, Neonix lets it work with a real project through a controlled remote connection.

Neonix remains responsible for authentication, workspace ownership, revisions, Neonix JSON V2 validation, preview, and export. The agent supplies intent; Neonix keeps the project safe and editable.

Streamable HTTP / OAuth / Neonix JSON V2 / Preview and export

Get started

No local renderer or package is required. Connect to the URL, sign in with your Neonix account when OAuth opens, and approve access to the workspace you want the client to use.

Hosted MCP endpoint:

https://www.neonix.video/api/mcp

Use a remote MCP client — Choose a host that supports Streamable HTTP MCP connections.
Authorize Neonix — OAuth connects the client to your account and workspace permissions.
Start with an HTML project — Ask the agent to create a complete HTML/CSS project.

Supported clients

Neonix's hosted MCP connection works the same way for every client: add the endpoint, complete OAuth, done. No API key or client ID to copy in — supported clients complete OAuth automatically when you add the connector, and any other MCP client registers itself the same way over standard OAuth dynamic client registration.

Chat apps — connect through the app's own settings UI:

Client	Description
Claude	Create and refine motion projects from a conversation.
ChatGPT	Turn structured intent into editable motion and exports.
Grok	Give Grok a secure connection to your Neonix workspace.

Developer tools — connect with a CLI command or a config file:

Client	Description
Claude Code	Add Neonix as a remote MCP server from the terminal.
Codex	Add Neonix to Codex's `config.toml` and call it from a session.
Cursor	Add Neonix to `mcp.json` and call it from the editor's agent.
Antigravity	Add Neonix to Antigravity's shared MCP config for its CLI and IDE.

Continue with Claude, ChatGPT, Grok, Claude Code, Codex, Cursor, or Antigravity.

Tools

The remote server exposes focused tools instead of one opaque generate call. Each operation is authenticated, validated, and scoped to the user's workspace.

Group	Description	Tools
Workspace & projects	Find workspaces and projects, manage HTML revisions, and open the Neonix editor.	`list_workspaces`, `list_projects`, `get_project`, `delete_project`, `open_editor`
HTML authoring	Use complete HTML/CSS as the high-level authoring source for a project.	`get_capabilities`, `validate_html`, `compile_html`, `create_project_html`, `get_project_html`, `update_project_html`, `list_html_revisions`, `get_html_revision`
Neonix JSON	Inspect canonical Neonix JSON V2 and apply a small validated JSON patch when needed.	`get_project_json`, `apply_json_patch`
Assets	List, upload, import, attach, and safely remove workspace media assets.	`list_assets`, `request_asset_upload`, `complete_asset_upload`, `import_asset`, `attach_asset_to_project`, `delete_asset`
Export jobs	Create an export from a saved revision, follow its status, and retrieve the result.	`create_export`, `get_export`, `get_export_download_url`, `cancel_export`

Recommended workflow

Start high-level, keep the source and revision history clear.

Create — For an HTML-first request, call get_capabilities, prepare a complete neonix-document, then use create_project_html.
Edit — Read with get_project_html, preserve the document metadata, validate with validate_html, then save with update_project_html.
Ship — Open the editor with open_editor, create an export from a saved revision, and retrieve the signed download URL when ready.

get_capabilities -> create_project_html -> open_editor
get_project_html -> validate_html -> update_project_html
create_export -> get_export -> get_export_download_url

Resources and prompts

neonix://docs/workflows — recommended create, edit, asset, and export flows.
neonix://docs/html-authoring — supported HTML/CSS boundary and Neonix JSON V2 rules.

Compatible hosts can attach the create_html_project and edit_html_project prompts and the resources above to give the agent the Neonix workflow before it calls a tool.

Important boundaries

HTML is the preferred high-level authoring source for HTML requests; Neonix JSON V2 remains canonical.
Exports run from saved revisions, not unsaved arbitrary JSON supplied in a tool call.
Destructive actions such as delete_project, delete_asset, and cancel_export should be confirmed first.