Connect an agent

Connect

Claude Code
Cursor and others

claude mcp add --transport http alien http://127.0.0.1:9876/mcp

{
  "mcpServers": {
    "alien": { "url": "http://127.0.0.1:9876/mcp" }
  }
}

Rhino and Grasshopper need to be open. The server tells the agent how to work with Alien when it connects, and its docs tool serves the full reference, so there’s nothing to paste into a prompt.

What your agent can do

Grasshopper

Tool	What it does
`canvas`	See the canvas: components, their state, pins and wires, and what you’ve selected
`add`	Place an Alien component with a new or existing script, or any Grasshopper component. Builds whole chains in one call
`wire`	Connect or disconnect wires
`delete`	Remove components (script files are kept)
`search`	Find components in the Grasshopper library
`script_read`	Read a component’s script
`script_edit`	Change a script and wait for the re-run, with any error and its line
`generate`	Describe a component: the same write, run and fix loop as the panel
`inspect`	Summarise a component’s data: counts, types, ranges, samples
`set_values`	Set inputs and re-run, or press a button
`bake`	Bake a component’s output into the Rhino document

Rhino

Tool	What it does
`doc`	Rhino and Grasshopper document info; save
`objects`	List and filter Rhino objects
`layers`	The layer tree; create and change layers
`view`	Set the viewport: view, camera, display mode, zoom
`capture`	A picture of the viewport or the canvas
`rhino`	Run a Rhino command
`run_code`	Run a short Python or C# snippet inside Rhino

Reference

Tool	What it does
`docs`	The Alien reference, by topic
`repo`	The script folder and, with `library: true`, every component by category plus the generated objects

In the next beta, changes made through add, wire, delete and set_values can be undone with Cmd/Ctrl+Z, the same as your own.

Get started

Using Alien

Ready-made components

Reference

Connect an agent

Connect

What your agent can do

Try it

Keep it local

​Connect

​What your agent can do

​Try it

​Keep it local

Connect

What your agent can do

Try it

Keep it local