Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

2.3 KB
Raw Blame

@autonomous-ai/harness-mcp

Harness as an MCP server, for clients that install servers from npm.

Harness runs coding agents (Claude Code, Codex, and other engines) in sessions of their own, on this computer or the person's other machines, and the person can watch and join every one in the Harness app. With this server an agent can start harnesses, wait for them, read their answers and close them:

Tool What it does
harness_whoami who you are to Harness, and whether you may start harnesses now: call it first
harness_list the harnesses here: state, who started each, what each is about
harness_search search every past and live conversation on this computer for the words that say them
harness_machines the machines on this account, for running a harness on another one
harness_start start an agent (claude, codex, opencode, pi, …) on a task, in a new project it owns (no trust prompt) or an existing folder (the engine asks the person to trust it)
harness_wait wait until harnesses stop working
harness_read a harness's last ask and its answer
harness_close close a harness you started

An agent may give work to, and close, only the harnesses it started.

Install

Harness itself (macOS or Linux; no account needed for harnesses on this computer):

curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash
harness start

On Linux the installer installs tmux and curl with apt-get, which asks for your password (or run sudo apt-get install -y tmux curl first).

Then add the server to your client, for example:

claude mcp add harness -- npx -y @autonomous-ai/harness-mcp
{ "mcpServers": { "harness": { "command": "npx", "args": ["-y", "@autonomous-ai/harness-mcp"] } } }

This package runs harness mcp from the installed CLI (or HARNESS_BIN). Where Harness is not installed, the server offers one tool, harness_setup, that says how to install it.

Claude Code and Codex can also install the Harness plugin, which brings a skill with it: see harness.autonomous.ai/agents.

MIT licensed. Source: autonomous-ai/openharness.