How do I use @perssona/orchestrator?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@perssona/orchestrator create a codex terminal for debugging the backend" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@perssona/orchestrator

Official

by PerssonaOps

Overview Schema Related Servers Score Discussions

JavaScript

Local

@perssona/orchestrator

MCP server that lets AI agents control Perssona — create terminals, manage canvas nodes, send prompts, and run multi-agent workflows.

npm version License: MIT

Requirements

Perssona must be running — the MCP communicates with the local bridge on 127.0.0.1:17381
Node.js 18+
Claude Code or Codex CLI

Related MCP server: interactive-process-mcp

Installation

Claude Code

claude mcp add --scope user perssona-orchestrator -- npx -y @perssona/orchestrator

Codex

Add to ~/.codex/config.toml:

[mcp_servers.perssona-orchestrator]
command = "npx"
args = ["-y", "@perssona/orchestrator"]
startup_timeout_sec = 60

Available Tools

Tool	Description
`create_connected_terminal`	Create a terminal node connected to a source node
`create_codex_terminal_from_agent`	Create a Codex terminal from an agent preset
`create_claude_terminal_from_agent`	Create a Claude terminal from an agent preset
`create_agent_pair`	Create two connected LLM terminals for parallel roles
`run_workflow_from_annotation`	Run a multi-agent workflow from an annotation or prompt
`send_text_to_terminal`	Send text directly to a specific terminal node
`send_text_to_connected_terminals`	Broadcast text to all terminals connected to a node
`send_annotation_to_connected_terminals`	Send annotation content to connected terminals
`create_annotation_node`	Create an annotation node on the canvas
`update_annotation_node`	Update an existing annotation node
`connect_nodes`	Connect two canvas nodes with an edge
`disconnect_nodes`	Remove the edge between two nodes
`remove_node`	Remove a node and its edges
`focus_node`	Select and center the viewport on a node
`add_node_to_grid`	Add a node to the grid view
`open_nodes_in_grid`	Open one or more nodes in the grid view
`get_selected_node`	Return the currently selected canvas node
`get_connected_nodes`	Return nodes connected to a given node
`list_canvas_nodes`	List all nodes and edges in the active canvas
`list_orchestrator_presets`	List workspace presets (models, agents, workflows)

Debug

Set PERSSONA_MCP_DEBUG=1 to write a log to your system temp directory:

PERSSONA_MCP_DEBUG=1 node server.mjs

Contributing

Contributions are welcome via Pull Requests.

The main branch is protected — direct pushes are not allowed
Open an issue first for bugs or feature proposals
Keep PRs focused and well-described

Open an issue · Submit a PR

License

MIT © Perssona

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/PerssonaOps/orchestrator'

If you have feedback or need assistance with the MCP directory API, please join our Discord server