How do I use Onda MCP?

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., "@Onda MCP run 'npm install' in a new tab" 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.

Onda MCP

by mindfullabai

Overview Schema Related Servers Score Discussions

JavaScript

Local

@mindfullabai/onda-mcp

MCP server to control Onda terminal from AI agents (Claude Code, Cursor, Windsurf, etc.)

31 tools across 7 categories let AI agents split panes, run commands, manage tabs and workspaces, coordinate across multiple windows, and orchestrate multi-agent workflows -- all through the standard Model Context Protocol.

Since v0.2.0 Onda MCP is multi-window aware: agents can discover windows, locate workspaces, address terminals unambiguously (each entry carries windowId + workspaceId + paneId), and launch full Claude/agent sessions in one atomic call with the onda_launch_session macro.

Requirements

Onda terminal running with IPC server active (automatic since v1.6)
Node.js 18+

Related MCP server: MCPretentious

Quick Start

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "onda": {
      "command": "npx",
      "args": ["-y", "@mindfullabai/onda-mcp"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "onda": {
      "command": "npx",
      "args": ["-y", "@mindfullabai/onda-mcp"]
    }
  }
}

Cursor / Windsurf

Same MCP config format as above.

Available Tools

Pane Management

Tool	Description
`onda_pane_split`	Split the active pane. Creates a new terminal beside (`right`) or below (`down`) the current one.
`onda_pane_list`	List all panes in the active tab. Returns pane IDs, terminal IDs, and content types.
`onda_pane_close`	Close a specific pane by ID. If no ID given, closes the active pane.
`onda_pane_focus`	Focus (activate) a specific pane by its ID.

Terminal Control

Tool	Description
`onda_terminal_run`	Run a command in a specific terminal (sends command + newline).
`onda_terminal_send`	Send raw text to a terminal without appending a newline. Use for interactive input or key sequences.
`onda_terminal_list`	List terminals with `{id, pid, cwd, alive, workspaceId, paneId, tabId, windowId}`. Optional input filters `workspaceId` / `windowId`.
`onda_terminal_spawn`	Spawn a binary inside an existing pane via `exec bin args...`, preserving multi-line/quoted argv. Use to start `claude` (or any agent) with a structured prompt in a pre-existing workspace pane.
`onda_terminal_kill`	Kill a terminal process by ID.

Tab Management

Tool	Description
`onda_tab_new`	Create a new tab. Each tab has its own layout of panes.
`onda_tab_list`	List all tabs with their IDs, titles, active state, and workspace.
`onda_tab_close`	Close a tab by ID. If no ID given, closes the active tab.
`onda_tab_focus`	Switch to (focus) a specific tab by ID.

Workspace Management

Tool	Description
`onda_workspace_list`	List workspaces with `{id, name, rootPath, mountedIn}` (mountedIn = windowId currently hosting that workspace, or null).
`onda_workspace_create`	Create a new workspace. Workspaces group tabs by project.
`onda_workspace_focus`	Switch to a workspace by ID.
`onda_workspace_add_terminal`	Add a new terminal pane to a workspace (tiled mode). Returns `{terminalId, paneId, workspaceId, windowId, ready}`. PTY-ready handshake is on by default — set `waitForReady:false` to skip.
`onda_workspace_tile`	Set the workspace tiling layout: `single`, `split-h`, `split-v`, or `quad`.
`onda_workspace_locate`	Resolve a workspace by `id` / `name` / `rootPath` without listing them all. Returns `{workspace: {id, name, rootPath, mountedIn}

Window (multi-window)

Tool	Description
`onda_window_list`	List Onda main windows. Each entry: `{windowId, isFocused, title, workspaceIds[], activeWorkspaceId, uiMode}`.
`onda_window_new`	Open a fresh empty main window. Returns `{windowId}`.
`onda_window_focus`	Bring a window to the foreground (restore + raise + focus). When `windowId` is omitted, focuses the primary window.
`onda_window_mount_workspace`	Mount a workspace in a specific window. Idempotent; orchestrates an atomic transfer if the workspace is currently owned by another window. Returns `{success, workspaceId, windowId, transferred}`.
`onda_workspace_unmount`	Remove a workspace from whichever window currently hosts it. The workspace continues to exist globally — only its on-screen mounting is dropped. Returns `{success, workspaceId, windowId, alreadyUnmounted}`.

Macro

Tool	Description
`onda_launch_session`	Atomic "ensure workspace + mount in target window + add terminal + spawn `bin` with `args`/`prompt`". Supports `placement: 'auto'` / `'current-window'` / `'window:<id>'` / `'new-window'` / `'ask-user'`. When `ask-user`, returns `{needsDecision: true, options, workspace}` so the host agent can surface the choice to the user, then re-invokes the tool with a concrete `placement`.

System

Tool	Description
`onda_context`	Get the Onda context for the current AI agent (paneId, tabId, workspaceId). Call this first.
`onda_status`	Get current session state: active workspace, tab, pane, and their details.
`onda_app_info`	Get Onda app info: version, process ID.
`onda_ping`	Health check -- verify Onda is running and responsive.

Environment Variables

Variable	Description	Default
`ONDA_SOCKET`	Path to Onda IPC socket	`~/.config/onda/onda.sock`
`ONDA_PANE_ID`	Pane ID where agent is running	auto-detected
`ONDA_TAB_ID`	Tab ID where agent is running	auto-detected
`ONDA_WORKSPACE_ID`	Workspace ID	auto-detected
`ONDA_TERMINAL`	Set to `"1"` when inside Onda	auto-detected

Agent-bus pattern (since v0.2.0)

Typical flow when an agent in window A delegates a task to another agent in workspace X (which may or may not be already mounted somewhere):

// 1. Try a fully-automatic launch
onda_launch_session({
  workspace: { name: "brandart-agentic-platform" },
  bin: "claude",
  prompt: "Scaffold modulo memoria — segui il brief #BAP-2026-05-20 ...",
  placement: "ask-user"
})

// → If multiple windows exist, the tool returns without acting:
{
  "needsDecision": true,
  "reason": "placement: ask-user",
  "options": [
    { "placement": "window:w-abc12345", "label": "Window w-abc1234 (current, focused)" },
    { "placement": "window:w-def67890", "label": "Window w-def6789" },
    { "placement": "new-window",        "label": "Open in a new window" }
  ],
  "workspace": { "id": "ws-...", "name": "brandart-agentic-platform", "rootPath": "/Users/mario/Projects/06-Brandart/brandart-agentic-platform" }
}

// 2. Host agent shows options to the human, gets choice, re-invokes:
onda_launch_session({ /* same args */, placement: "window:w-abc12345" })
// → { windowId, workspaceId, terminalId, paneId, pid }
// Claude is now running in that pane with the brief as its initial prompt.

After launch, the caller can keep talking to the spawned agent via onda_terminal_send / onda_terminal_run using the returned terminalId, or use onda_terminal_list (now enriched with workspaceId/windowId) to disambiguate which terminal belongs to which session.

Architecture

Communicates with Onda via Unix domain socket
Protocol: JSON-RPC 2.0 over newline-delimited JSON
Socket path: ~/.config/onda/onda.sock
Transport: stdio (standard MCP transport)

AI Agent  <--stdio-->  onda-mcp  <--Unix socket-->  Onda Terminal

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

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

Related MCP Servers

cmuxlayer
Agent Orchestration Shell Access Autonomous Agents
EtanHey
A
license
A
quality
B
maintenance
Terminal multiplexer MCP server for orchestrating parallel AI agents. Manages workspaces, panes, surfaces with send_input/read_screen/spawn_agent/stop_agent tools. Supports Claude Code, Codex, Gemini, Cursor CLI agents with lifecycle management, browser automation, and agent status push via Claude --channels.
Updated 5 hours ago (2026-08-23 18:18 UTC)
20
25
Apache 2.0
MCPretentious
Command Line Shell Access
oetiker
A
license
A
quality
C
maintenance
MCP server for terminal control enabling AI to manage terminal sessions via iTerm2 or tmux, with features like screen reading, keyboard/mouse input, and background execution.
Updated 6 months ago (2026-02-14 11:59 UTC)
9
57
21
MIT
hyperpanes-mcp
Shell Access Command Line Agent Orchestration
Eyalm321
A
license
A
quality
A
maintenance
MCP server for hyperpanes terminal workspace app, enabling AI agents to compose and launch workspace layouts, inspect and drive terminal panes, stream output, and orchestrate agent hierarchies.
Updated 23 days ago (2026-07-31 14:13 UTC)
47
1
MIT
mcp-tmux
Shell Access Command Line
laszlopere
A
license
B
quality
A
maintenance
A comprehensive MCP server for driving tmux sessions, windows, panes, sending keystrokes, and reading pane output locally or over SSH, enabling real-time collaborative pairing with AI.
Updated 2 months ago (2026-06-19 04:00 UTC)
71
1
MIT

View all related MCP servers

Related MCP Connectors

microservices.sh
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
mcp-server
Remote MCP server for The Colony — a social network for AI agents (posts, DMs, search, marketplace).
gainium-mcp
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/mindfullabai/onda-mcp'

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