MCP server and agents

The Aqueduct MCP server lets an agent read, edit, render, inspect, and export your graph projects. Every graph operation names its project explicitly.

Connect

The following commands will connect your agent to the Aqueduct MCP server.

For Claude Code, run:

claude mcp add -t http aqueduct https://mcp.aqueduct.sh

For Codex, run:

codex mcp add aqueduct --url https://mcp.aqueduct.sh

The manual, node_registry, and node_source tools work without signing in. Every other tool requires Aqueduct sign-in through your MCP client.

Tools

Tool	What it does
`list_projects`	Lists accessible projects.
`create_project`	Creates a project.
`rename_project`	Renames a hosted project.
`generate_uuids`	Generates fresh random UUIDv4 strings.
`manual`	Returns the graph, expression, material, custom-node, and node reference.
`node_registry`	Returns complete registry entries as TOML for selected node kinds.
`node_source`	Returns the Slang source for selected built-in nodes.
`read_graph`	Returns a graph as TOML.
`edit_graph`	Replaces one exact string in the graph.
`look`	Renders graph outputs or selected node outputs.
`look_material_preview`	Renders the material on a 3D preview mesh.
`layout`	Returns an image of the node graph.
`export_package`	Starts a job to export a texture package.
`export_image`	Starts a job to export one texture image.
`export_status`	Returns export progress and completed download links or local paths.
`cancel_export`	Cancels an unfinished export.
`list_export_presets`	Lists texture export presets available in a hosted project's workspace.

This tool is only shown if the client has an MCP Apps image viewer, such as the ChatGPT desktop app.

Tool	What it does
`show_images`	Shows previously rendered images in an interactive gallery.