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

Your MCP client opens Aqueduct sign-in when it first connects to the hosted server.

Tools

Tool	What it does
`list_projects`	Lists accessible projects.
`create_project`	Creates a project.
`rename_project`	Renames a hosted project.
`manual`	Returns the graph, expression, material, custom-node, and node reference.
`node_definition`	Returns full definitions 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.
`render`	Renders graph outputs or selected node outputs.
`preview`	Renders the material on a 3D preview mesh.
`layout`	Returns an image of the node graph.
`export`	Returns full-resolution output downloads.

An agent must call manual once before it can use the graph tools.