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.

Listing kit: MCP bundle, server.json, Cursor plugin, Glama files and editor install links (#1193)

Deef52b31470b47
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
new file mode 100644
index 000000000..2480f665c
--- /dev/null
+++ b/.cursor-plugin/marketplace.json
@@ -0,0 +1,16 @@
+{
+ "name": "openharness",
+ "owner": {
+ "name": "Autonomous"
+ },
+ "metadata": {
+ "description": "Harness for agents: run Claude Code, Codex and other coding agents in parallel, wait for them and read their answers, while the person watches every one."
+ },
+ "plugins": [
+ {
+ "name": "harness",
+ "source": "plugins/harness",
+ "description": "Start, wait for, read and close other coding agents through Harness: the harness skill and Harness's MCP server."
+ }
+ ]
+}
diff --git a/Makefile b/Makefile
index 7332b76a4..a2a4860cc 100644
--- a/Makefile
+++ b/Makefile
@@ -4,7 +4,7 @@
# make install-cli ARGS="--no-restart"
# make release-cli ARGS="--dry-run"
-.PHONY: validate merge-pr desktop-test cli-test install-cli upload-cli-install-sh release-cli release-backend release-desktop release-web remote-machine upload-circle upload-pro device-test
+.PHONY: validate merge-pr desktop-test cli-test install-cli upload-cli-install-sh release-cli mcpb release-backend release-desktop release-web remote-machine upload-circle upload-pro device-test
## validate: bounded independent checks with logs and a source/timing receipt.
## See docs/validation-and-release.md. ARGS="path/to/plan.json".
@@ -32,6 +32,13 @@ cli-test:
release-cli:
bash cli/scripts/release-cli.sh $(ARGS)
+## mcpb: build harness-mcp.mcpb (Harness's MCP Bundle, for Claude Desktop, the Official MCP Registry and
+## Smithery) and the server.json to publish it with, into cli/packages/harness-mcp/mcpb/dist/, and print its
+## sha256. ARGS="X.Y.Z" names the CLI release it goes on (tag vX.Y.Z_cli). Uploads and publishes nothing:
+## docs/research/2026-10-11-listing-submissions.md has the steps.
+mcpb:
+ node cli/packages/harness-mcp/mcpb/build.mjs $(ARGS)
+
## release-backend: tag this commit vX.Y.Z_backend and push the tag — CI builds the backend's Docker
## image and rolls it out. ARGS=minor|major|X.Y.Z to bump differently, ARGS=--dry-run to preview.
## See backend/scripts/release-be.sh.
diff --git a/cli/RELEASE.md b/cli/RELEASE.md
index 6213dc778..f95f325f3 100644
--- a/cli/RELEASE.md
+++ b/cli/RELEASE.md
@@ -93,6 +93,17 @@ cd cli/packages/harness-mcp && npm publish --access public
Its tests are `cli/src/agentClient/mcpPackage.spec.ts`, in `make cli-test`.
+`harness-mcp.mcpb`, the same server as an MCP Bundle (Claude Desktop, the Official MCP Registry, Smithery), goes on
+a CLI release as an asset, by hand, after the release workflow has cut it:
+
+```bash
+make mcpb ARGS="X.Y.Z" # writes cli/packages/harness-mcp/mcpb/dist/ and prints the sha256
+gh release upload vX.Y.Z_cli cli/packages/harness-mcp/mcpb/dist/harness-mcp.mcpb --repo autonomous-ai/openharness
+```
+
+Publishing it, and every other listing, is in
+[docs/research/2026-10-11-listing-submissions.md](../docs/research/2026-10-11-listing-submissions.md).
+
## Local install (no upload)
`bash cli/scripts/install-cli.sh` bundles **this working tree** into `~/.harness/cli` — the same
diff --git a/cli/docker/harness-mcp/Dockerfile b/cli/docker/harness-mcp/Dockerfile
new file mode 100644
index 000000000..3e52685de
--- /dev/null
+++ b/cli/docker/harness-mcp/Dockerfile
@@ -0,0 +1,40 @@
+# Harness's MCP server, `harness mcp`, in a box: for directories that list a server by building it and asking it
+# what it offers (Glama starts it and sends `initialize` and `tools/list`). It is not a way to use Harness. A
+# harness is an agent in tmux on the person's own computer, and this box has no daemon and no agents, so every tool
+# call here answers "Harness is not running here". What it shows a directory is the real tool list.
+#
+# The CLI comes from the official installer, as a person gets it (cli/scripts/install.sh, which brings its own Node).
+# `harness mcp` answers `initialize` and `tools/list` without a daemon or a tmux server (checked on 2026-10-11 from
+# the sources, with a throwaway HOME and no tmux on PATH). The installer installs the published CLI: `harness mcp`
+# is in releases after 0.3.73.
+#
+# From this folder (the build copies nothing in):
+# docker build -t harness-mcp .
+# printf '%s\n' \
+# '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"0"}}}' \
+# '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | docker run -i --rm harness-mcp
+#
+# Debian 13 (trixie) for the reason cli/docker/remote-machine gives: the managed grid the installer fetches needs
+# glibc 2.38.
+FROM debian:trixie-slim
+
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+
+# curl and ca-certificates fetch the installer; tmux and procps (`ps`) are what it would otherwise install with
+# apt-get, which a user without root cannot.
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends ca-certificates curl tmux procps \
+ && rm -rf /var/lib/apt/lists/*
+
+# Not root: Harness installs into the user's home and needs no privileges.
+RUN useradd --create-home --shell /bin/bash harness
+USER harness
+WORKDIR /home/harness
+
+RUN curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash
+
+ENV PATH="/home/harness/.local/bin:${PATH}"
+
+# MCP over stdio: newline-delimited JSON-RPC on stdin and stdout, nothing else on stdout.
+CMD ["harness", "mcp"]
diff --git a/cli/packages/harness-mcp/mcpb/build.mjs b/cli/packages/harness-mcp/mcpb/build.mjs
new file mode 100644
index 000000000..b2f9aecd7
--- /dev/null
+++ b/cli/packages/harness-mcp/mcpb/build.mjs
@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * Builds harness-mcp.mcpb, Harness's MCP Bundle (github.com/modelcontextprotocol/mcpb): what Claude Desktop installs
+ * from a file, and what the Official MCP Registry and Smithery list a local server by. Also writes the server.json
+ * to publish it to the registry with.
+ *
+ * make mcpb ARGS="0.3.74" # or: node cli/packages/harness-mcp/mcpb/build.mjs 0.3.74
+ *
+ * The version is the CLI release the bundle is attached to, so the tag defaults to v<version>_cli (`--tag` to
+ * override). Into cli/packages/harness-mcp/mcpb/dist/ it writes:
+ * harness-mcp.mcpb manifest.json from this folder at that version, the npm package's bin.mjs and index.mjs as its
+ * server, and the app's icon
+ * server.json the repository's server.json with the version, the asset's URL, its sha256 and the npm
+ * package's version filled in
+ * and prints the sha256. It uploads and publishes nothing; docs/research/2026-10-11-listing-submissions.md has the
+ * steps that do.
+ *
+ * Its server is the npm package's (`npx -y @autonomous-ai/harness-mcp`): it runs `harness mcp` from the installed CLI,
+ * or, where Harness is not installed, offers one tool that says how to install it. A bundle cannot just name
+ * `harness`: mcpb refuses a manifest whose entry_point is not a file in the bundle, and an app opened from the Finder
+ * starts with launchd's bare PATH, which leaves out ~/.local/bin, where the installer puts `harness`. The wrapper
+ * looks there too. Claude Desktop runs a "node" bundle on its own Node, so the person needs none.
+ */
+import { execFileSync } from 'node:child_process'
+import { createHash } from 'node:crypto'
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join, relative } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+/** The mcpb CLI, pinned: `pack` validates the manifest against this version's schemas (manifest_version 0.3). */
+export const MCPB = '@anthropic-ai/[email protected]'
+export const ASSET = 'harness-mcp.mcpb'
+export const RELEASES = 'https://github.com/autonomous-ai/openharness/releases/download'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const repo = join(here, '..', '..', '..', '..')
+const wrapper = join(here, '..')
+const icon = join(repo, 'desktop', 'macos', 'Runner', 'Assets.xcassets', 'AppIcon.appiconset', 'app_icon_512.png')
+
+/** The server.json to publish for one release, from the repository's (which holds placeholders). */
+export function releasedServerJson(template, { version, tag, sha256, npmVersion }) {
+ const server = structuredClone(template)
+ server.version = version
+ for (const pkg of server.packages) {
+ if (pkg.registryType === 'mcpb') {
+ pkg.identifier = `${RELEASES}/${tag}/${ASSET}`
+ pkg.fileSha256 = sha256
+ }
+ if (pkg.registryType === 'npm') pkg.version = npmVersion
+ }
+ return server
+}
+
+function fail(message) {
+ console.error(`✗ ${message}`)
+ process.exit(1)
+}
+
+function main(argv) {
+ const usage = 'usage: build.mjs <version X.Y.Z> [--tag <release tag>] (make mcpb ARGS="0.3.74")'
+ const at = argv.indexOf('--tag')
+ const tagArg = at >= 0 ? argv[at + 1] : undefined
+ const words = argv.filter((word, i) => !(at >= 0 && (i === at || i === at + 1)))
+ const version = words[0]
+ if (words.length !== 1 || !/^\d+\.\d+\.\d+$/.test(version ?? '') || (at >= 0 && !tagArg)) {
+ console.error(usage)
+ process.exit(2)
+ }
+ const tag = tagArg ?? `v${version}_cli`
+
+ for (const file of ['bin.mjs', 'index.mjs', 'package.json']) {
+ if (!existsSync(join(wrapper, file))) fail(`${relative(repo, join(wrapper, file))} is missing: the bundle's server is the npm package's.`)
+ }
+ if (!existsSync(icon)) fail(`The icon is missing: ${relative(repo, icon)}`)
+ const npm = JSON.parse(readFileSync(join(wrapper, 'package.json'), 'utf8'))
+ const template = JSON.parse(readFileSync(join(repo, 'server.json'), 'utf8'))
+ // The registry checks that the npm package names this server (`mcpName`); a mismatch fails only at publish.
+ if (npm.mcpName !== template.name) fail(`package.json mcpName ${npm.mcpName} is not server.json's name ${template.name}`)
+
+ const stage = mkdtempSync(join(tmpdir(), 'harness-mcpb-'))
+ try {
+ const manifest = JSON.parse(readFileSync(join(here, 'manifest.json'), 'utf8'))
+ manifest.version = version
+ writeFileSync(join(stage, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`)
+ mkdirSync(join(stage, 'server'))
+ copyFileSync(join(wrapper, 'bin.mjs'), join(stage, 'server', 'bin.mjs'))
+ copyFileSync(join(wrapper, 'index.mjs'), join(stage, 'server', 'index.mjs'))
+ copyFileSync(icon, join(stage, 'icon.png'))
+
+ const out = join(here, 'dist')
+ mkdirSync(out, { recursive: true })
+ const bundle = join(out, ASSET)
+ rmSync(bundle, { force: true })
+ execFileSync('npx', ['-y', MCPB, 'pack', stage, bundle], { stdio: 'inherit' })
+
+ const sha256 = createHash('sha256').update(readFileSync(bundle)).digest('hex')
+ const server = join(out, 'server.json')
+ writeFileSync(server, `${JSON.stringify(releasedServerJson(template, { version, tag, sha256, npmVersion: npm.version }), null, 2)}\n`)
+
+ console.log('')
+ console.log(`✓ ${relative(process.cwd(), bundle)}`)
+ console.log(` sha256 ${sha256}`)
+ console.log(`✓ ${relative(process.cwd(), server)} (version ${version}, ${tag}, ${npm.name}@${npm.version})`)
+ console.log('')
+ console.log('Nothing is uploaded or published. Once the release exists:')
+ console.log(` gh release upload ${tag} ${relative(process.cwd(), bundle)} --repo autonomous-ai/openharness`)
+ console.log(` mcp-publisher publish ${relative(process.cwd(), server)}`)
+ } finally {
+ rmSync(stage, { recursive: true, force: true })
+ }
+}
+
+if (import.meta.url === pathToFileURL(process.argv[1] ?? '').href) main(process.argv.slice(2))
diff --git a/cli/packages/harness-mcp/mcpb/manifest.json b/cli/packages/harness-mcp/mcpb/manifest.json
new file mode 100644
index 000000000..595b45313
--- /dev/null
+++ b/cli/packages/harness-mcp/mcpb/manifest.json
@@ -0,0 +1,60 @@
+{
+ "manifest_version": "0.3",
+ "name": "harness",
+ "display_name": "Harness",
+ "version": "0.0.0",
+ "description": "Start Claude Code and Codex agents the person can watch, wait for them and read their answers.",
+ "long_description": "Harness runs coding agents (Claude Code, Codex) in sessions of their own, on this computer or the person's other machines. The person can watch and join every one in the Harness app. With this extension, Claude can start harnesses, wait for them, read their answers and close them.\n\n**It needs the Harness CLI** (macOS or Linux):\n\n```\ncurl -fsSL https://harness.autonomous.ai/cli/install.sh | bash\nharness start\n```\n\nNo account is needed for harnesses on this computer. Until the CLI is installed, the extension offers one tool, `harness_setup`, that says how to install it.\n\nClaude may give work to, and close, only the harnesses it started. The rest are the person's.",
+ "author": {
+ "name": "Autonomous",
+ "url": "https://harness.autonomous.ai"
+ },
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/autonomous-ai/openharness"
+ },
+ "homepage": "https://harness.autonomous.ai/agents",
+ "documentation": "https://harness.autonomous.ai/agents",
+ "support": "https://github.com/autonomous-ai/openharness/issues",
+ "icon": "icon.png",
+ "server": {
+ "type": "node",
+ "entry_point": "server/bin.mjs",
+ "mcp_config": {
+ "command": "node",
+ "args": ["${__dirname}/server/bin.mjs"]
+ }
+ },
+ "tools": [
+ {
+ "name": "harness_list",
+ "description": "The harnesses on this machine: name, agent, state, who started each, when it was last active, its folder, and what it is about."
+ },
+ {
+ "name": "harness_start",
+ "description": "Start a new harness: an agent in a session of its own, working on a task in a folder. Returns at once."
+ },
+ {
+ "name": "harness_wait",
+ "description": "Wait until harnesses stop working, then say each one's state."
+ },
+ {
+ "name": "harness_read",
+ "description": "A harness's state and its last turn: what it was asked and what it answered."
+ },
+ {
+ "name": "harness_close",
+ "description": "Close a harness you started, once it is done. Its conversation is kept: the person can resume it."
+ }
+ ],
+ "tools_generated": true,
+ "keywords": ["agents", "parallel", "claude-code", "codex", "orchestration", "tmux"],
+ "license": "MIT",
+ "privacy_policies": ["https://www.autonomous.ai/privacy"],
+ "compatibility": {
+ "platforms": ["darwin", "linux"],
+ "runtimes": {
+ "node": ">=18.0.0"
+ }
+ }
+}
diff --git a/docs/research/2026-10-11-listing-submissions.md b/docs/research/2026-10-11-listing-submissions.md
new file mode 100644
index 000000000..a54e47473
--- /dev/null
+++ b/docs/research/2026-10-11-listing-submissions.md
@@ -0,0 +1,406 @@
+# Listing submissions
+
+October 11, 2026. What to paste and what to run for each directory in
+[the checklist](2026-10-11-where-to-list-harness.md). Nothing here has been submitted or published. **Owner** marks a
+step that needs an account only the owner (or an Owner of the `autonomous-ai` GitHub organization) has; the rest
+needs only a GitHub account that can open a pull request. Formats and limits were read from each directory's docs or
+repository on this date; **unverified** marks what could not be confirmed there.
+
+## Before any of it
+
+| Waits for | What |
+|---|---|
+| Monday's CLI release, the first with `harness mcp` | the `.mcpb` asset, the registry, Smithery, Glama's image, deploying `/agents` and `/llms.txt` |
+| `@autonomous-ai/harness-mcp` published to npm (`cli/packages/harness-mcp`, `cli/RELEASE.md`; an npm account in the `autonomous-ai` organization, **Owner**) | the npm entry in `server.json`, the goose link and every `npx` line |
+| Glama's listing and its badge | the largest MCP awesome list |
+
+### The bundle, after the release
+
+`make release-cli` tags `vX.Y.Z_cli` and CI cuts the GitHub Release. Then, from a checkout of that commit, with the
+released version:
+
+```
+make mcpb ARGS="<version>"
+gh release upload v<version>_cli cli/packages/harness-mcp/mcpb/dist/harness-mcp.mcpb --repo autonomous-ai/openharness
+curl -fsSL https://github.com/autonomous-ai/openharness/releases/download/v<version>_cli/harness-mcp.mcpb | shasum -a 256
+```
+
+`make mcpb` prints the bundle's sha256 and writes `cli/packages/harness-mcp/mcpb/dist/server.json` with the version,
+the asset's URL, that sha256 and the npm package's version. The last line must print the same sha256. A rebuild a
+minute later gives another one (the zip records file times), so upload the file that build wrote and do not rebuild in between. Uploading
+to a release needs write access to the repository.
+
+## The text
+
+Privacy policy, where a directory asks for one: https://www.autonomous.ai/privacy (Autonomous, Inc.; also in the
+bundle manifest's `privacy_policies`).
+
+Use the same words everywhere.
+
+- **Name**: Harness
+- **Repository**: https://github.com/autonomous-ai/openharness (MIT)
+- **Page for agents**: https://harness.autonomous.ai/agents · plain text: https://harness.autonomous.ai/llms.txt
+- **Plugin**: https://github.com/autonomous-ai/openharness/tree/main/plugins/harness
+- **Skill**: https://github.com/autonomous-ai/openharness/blob/main/plugins/harness/skills/harness/SKILL.md
+- **Very short** (29 characters, for limits of 30): Run coding agents in parallel
+- **Short** (94 characters; the registry allows 100): Start Claude Code and Codex agents the person can watch,
+ wait for them and read their answers.
+- **One line** (for lists): Run Claude Code and Codex agents in tmux sessions the person can watch: start, wait for,
+ read and close them over MCP or the CLI.
+- **Long**:
+
+ > Harness runs coding agents (Claude Code, Codex and others) in terminal sessions called harnesses, on the
+ > person's own computers, and shows every one in its desktop, web and phone apps. An agent uses it to run other
+ > agents beside its own work: start a harness on a task in a folder, wait for it, read its answer, send it a
+ > follow-up and close it. The person can watch, answer or stop any of them.
+ >
+ > It comes as a CLI (`harness ps`, `new`, `wait`, `show`, `send`, `close`), an MCP server over stdio
+ > (`harness mcp`) and a skill. An agent may give work to, and close, only the harnesses it started; the rest are
+ > the person's. It runs on macOS and Linux, and needs no account for harnesses on the same computer.
+
+- **Tags**: agents, parallel, claude-code, codex, orchestration, tmux, mcp, developer-tools
+- **Tools**:
+
+ | Tool | What it does |
+ |---|---|
+ | `harness_list` | the harnesses on this machine: state, who started each, what each is about |
+ | `harness_start` | start Claude Code or Codex on a task in a folder, by name; returns at once |
+ | `harness_wait` | wait until harnesses stop working (up to 600 seconds a call) |
+ | `harness_read` | a harness's state, its last ask and its answer |
+ | `harness_close` | close a harness it started; the conversation is kept |
+ | `harness_send` | a follow-up to a harness it started; offered only when the server runs inside a harness |
+
+ Where Harness is not installed, the npm package and the bundle offer one tool instead, `harness_setup`, which
+ says how to install it.
+
+- **Install**:
+
+ ```
+ curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash
+ harness start
+ ```
+
+ MCP, with the CLI on the PATH: `{"command": "harness", "args": ["mcp"]}`.
+ MCP, for clients that take npx: `npx -y @autonomous-ai/harness-mcp` (it runs `harness mcp`).
+ Claude Code: `claude mcp add harness -- npx -y @autonomous-ai/harness-mcp`, or the plugin:
+ `claude plugin marketplace add autonomous-ai/openharness --sparse .claude-plugin plugins`, then
+ `claude plugin install harness@openharness`.
+ Codex: `codex plugin marketplace add autonomous-ai/openharness --sparse .claude-plugin --sparse plugins`, then
+ `codex plugin add harness@openharness`.
+
+- **What it runs and fetches** (for forms that ask): the plugin, the npm package and the bundle run the `harness`
+ command (`harness mcp`) and nothing else. The installer (`cli/scripts/install.sh`) downloads, checksum-verified,
+ a Node runtime, the CLI, its terminal client `hn` and the `grid` tool from Harness's release storage into
+ `~/.harness`, links `harness` into `~/.local/bin`, and gets tmux where it is missing (Homebrew, apt, or a managed
+ build on a Mac). On a computer with no coding agent, run by a person at a terminal, it also downloads OpenCode.
+ Harnesses, their files and transcripts stay on the person's computers; only what reaches the person's other
+ machines and phone, after `harness login`, goes through Harness's relay.
+
+## 1. Official MCP Registry (registry.modelcontextprotocol.io) — **Owner**
+
+Publishes `server.json`: the npm package and the `.mcpb`, both run over stdio. Clients and directories that read the
+registry (PulseMCP among them) pick it up from there.
+
+Order matters: the registry fetches `https://registry.npmjs.org/@autonomous-ai/harness-mcp/<version>` and refuses the
+entry unless its `mcpName` is `io.github.autonomous-ai/harness`, and it sends a HEAD request to the `.mcpb` URL. So
+publish the npm package and upload the bundle first. A published version cannot be changed; the next one needs a new
+`version`.
+
+```
+brew install mcp-publisher
+mcp-publisher login github # as an Owner of the autonomous-ai organization
+mcp-publisher validate cli/packages/harness-mcp/mcpb/dist/server.json
+mcp-publisher publish cli/packages/harness-mcp/mcpb/dist/server.json
+curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.autonomous-ai/harness"
+```
+
+`login github` grants `io.github.autonomous-ai/*` only to an Owner of the organization; a member gets their own
+`io.github.<user>/*`. A token used in CI needs `read:org` (or, fine-grained, Members: read) for the organization.
+
+The alternative name, `ai.autonomous.harness/harness`, needs no organization role, only the website:
+
+```
+openssl genpkey -algorithm Ed25519 -out key.pem
+echo "v=MCPv1; k=ed25519; p=$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
+# serve that line at https://harness.autonomous.ai/.well-known/mcp-registry-auth, then:
+mcp-publisher login http --domain harness.autonomous.ai \
+ --private-key "$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
+```
+
+Choosing it means changing `name` in `server.json`, `mcpName` in `cli/packages/harness-mcp/package.json` (and
+republishing the npm package), and the name `website/scripts/listings.spec.ts` expects. Keep the key out of the
+repository.
+
+`mcp-publisher validate` (1.8.1) passed on 2026-10-11 for both the repository's `server.json` and one `make mcpb`
+built for a sample version, 0.3.74. On that date the registry had nothing under `io.github.autonomous-ai` or
+`ai.autonomous`.
+
+## 2. Smithery (smithery.ai) — **Owner**
+
+Smithery takes a local server only as an `.mcpb` bundle: its publish command and web form take a public HTTPS URL or a
+bundle, and nothing installs from npm there. So Smithery gets the bundle.
+
+```
+npm install -g smithery@latest # Node 20 or later
+smithery auth login
+smithery namespace list # or create one: smithery namespace create <name>
+smithery mcp publish cli/packages/harness-mcp/mcpb/dist/harness-mcp.mcpb -n <namespace>/harness
+```
+
+`mcp publish` creates the server but not the namespace: a namespace (lowercase letters, digits and hyphens, unique
+across Smithery) has to exist first. The name, description and links are set after publishing, on the server's
+page or through Smithery's "Update a server" API: display name **Harness**, the short description, homepage
+`https://harness.autonomous.ai/agents`, repository `https://github.com/autonomous-ai/openharness`, license MIT, an
+icon of 1 MB at most. Then Settings → Verification for the vendor checklist.
+
+## 3. PulseMCP (pulsemcp.com)
+
+Nothing to submit: its form is paused, and it says it picks servers up from the Official MCP Registry (step 1).
+
+## 4. Cursor — **Owner** for the marketplace
+
+**Marketplace** (cursor.com/marketplace/publish, signed in to Cursor): it is an application to become a plugin
+publisher. Fields:
+
+| Field | Value |
+|---|---|
+| Organization name | Autonomous |
+| Organization handle | `autonomous` (kebab-case, unique; the owner's choice) |
+| Contact email | the owner's choice; not written here |
+| Logotype URL | `https://raw.githubusercontent.com/autonomous-ai/openharness/main/plugins/harness/assets/logo.svg` (1:1 SVG or PNG on a background plate; check that this one reads on Cursor's background) |
+| Description | Start Claude Code and Codex agents the person can watch, wait for them and read their answers. |
+| GitHub repository | `https://github.com/autonomous-ai/openharness` |
+| Website URL | `https://harness.autonomous.ai/agents` |
+
+Cursor reads `.cursor-plugin/marketplace.json`, which lists one
+plugin, `harness`, at `plugins/harness` (`.cursor-plugin/plugin.json`, the `harness` skill, `mcp.json`, the logo
+`assets/logo.svg`). Every plugin and update is reviewed by hand. Before submitting, load it locally: copy
+`plugins/harness` to `~/.cursor/plugins/local/harness`, run **Developer: Reload Window**, and check under
+**Customize** that the skill and the MCP server load. Cursor must find `harness` on its PATH.
+
+**Add to Cursor**, no submission (on `/agents`):
+
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=harness&config=eyJjb21tYW5kIjoiaGFybmVzcyIsImFyZ3MiOlsibWNwIl19
+```
+
+## 5. Glama (glama.ai/mcp/servers) — **Owner** (GitHub, as a maintainer named in `glama.json`)
+
+1. **Add MCP Server** → **Runs from source**: Name `harness` (100 characters at most); Description (400 at most):
+ "Start Claude Code and Codex agents the person can watch, wait for them and read their answers. Runs the Harness
+ CLI's MCP server (harness mcp) over stdio; macOS and Linux."; GitHub Repository URL
+ `https://github.com/autonomous-ai/openharness`. **Submit for Review**. After approval Glama emails how to provide
+ the Dockerfile; only servers that pass its checks are indexed.
+2. **Claim** it: `glama.json` at the root names `deehw`. Sign in to Glama with that GitHub account and run the claim;
+ run it again after any change to `glama.json`. An organization's repository can be claimed only this way.
+3. **The Dockerfile** (as Glama's email says, or on the server's admin page once claimed): Glama builds the server,
+ starts it and asks `initialize` and `tools/list`; the listing and its score badge depend on that. Use the image in `cli/docker/harness-mcp/Dockerfile`: Debian with tmux and `ps`,
+ the official installer, then `harness mcp`. Checked on 2026-10-11: the image builds, and with the CLI from the
+ sources in it (the released 0.3.73 has no `harness mcp`), it answers `initialize` and lists the five tools with
+ no daemon and no tmux server running; a tool call answers "Harness is not running here".
+
+ If the page asks for fields rather than a Dockerfile (one third-party note says it generates the Dockerfile from
+ build steps and command arguments; **unverified**): build step `curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash`,
+ command `$HOME/.local/bin/harness mcp`, no environment variables.
+
+Why not the npm package here: Glama lists what `tools/list` returns. An image with only
+`npx -y @autonomous-ai/harness-mcp` and no Harness would list one tool, `harness_setup`, not the five. The CLI has
+to be in the image either way, and then `harness mcp` needs no wrapper.
+
+## 6. Claude Desktop
+
+No submission: Anthropic's directory no longer accepts bundles (its desktop extension listings are deprecated; a
+local server is listed inside a plugin, step 8). The bundle is the install: download `harness-mcp.mcpb` from the
+release and double-click it, drop it on the Claude Desktop window, or use **Settings → Extensions → Advanced settings
+→ Install Extension…**. It runs on the Node that Claude Desktop ships on macOS; until the CLI is installed it offers
+`harness_setup`. Source: claude.com/docs/connectors/building/mcpb.
+
+## 7. Other editors' install links (on `/agents`)
+
+No submission; each hands the server's config to the editor, which adds it (Cursor asks first, as its docs say).
+
+| Editor | Link |
+|---|---|
+| VS Code | `vscode:mcp/install?%7B%22name%22%3A%22harness%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22harness%22%2C%22args%22%3A%5B%22mcp%22%5D%7D` |
+| VS Code Insiders | the same with `vscode-insiders:` |
+| LM Studio | `lmstudio://add_mcp?name=harness&config=eyJjb21tYW5kIjoiaGFybmVzcyIsImFyZ3MiOlsibWNwIl19` |
+| goose | `goose://extension?cmd=npx&arg=-y&arg=%40autonomous-ai%2Fharness-mcp&timeout=660&id=harness&name=Harness&description=…` (goose runs only commands such as `npx`, so it uses the npm package) |
+
+Use them from web pages such as `/agents`. Whether a README on github.com keeps these schemes as links is
+**unverified**; some projects wrap VS Code's in `https://insiders.vscode.dev/redirect?url=` for that reason.
+
+## 8. Anthropic's plugin directory (claude.ai/directory) — **Owner**
+
+Needs a plan and role that can submit, and on claude.ai a connected GitHub account that can push to
+`autonomous-ai/openharness`. Nothing to paste for the listing: its name and descriptions come from
+`plugins/harness/.claude-plugin/plugin.json` and the plugin's README.
+
+1. `claude plugin validate ./plugins/harness` from the repository root (passes; the one warning is the `version` left
+ out on purpose).
+2. claude.ai/directory/manage → **Submit new** → **Plugin bundle**.
+3. **Source**: Repository `autonomous-ai/openharness`; Plugin path `plugins/harness`; Branch or tag empty (follows
+ `main`). **Validate**.
+4. **Data handling**, suggested answers for the owner to confirm: reads or stores personal data: it runs agents on
+ the person's own files and keeps their transcripts on the person's computer; sends data to other services: no,
+ except Harness's own relay when the person has signed in to reach their other machines; retention: on the
+ person's computer until they delete it; intended for people under 18: no.
+5. **Compliance**: a contact address for the submission (the owner's choice; not written here), the four
+ acknowledgements.
+6. **Review and submit**: keep **GitHub push webhook** (setting it up needs admin access to the repository).
+
+Expect it to be held for a reviewer: the plugin's MCP server runs `harness` from the PATH rather than a file inside
+the plugin, and the README says that the CLI is installed with curl.
+
+## 9. OpenAI's plugin directory (ChatGPT and Codex) — **Owner**, skills only
+
+The portal does not take a local MCP server or an `.mcpb` (it asks for a public HTTPS server), so Harness goes as
+the skill alone. Needs the Owner role or Apps Management Write on the OpenAI organization, and individual or business
+verification. platform.openai.com/plugins → **Create plugin** → **Skills only**, then upload:
+
+```
+rm -rf /tmp/harness-skills && mkdir -p /tmp/harness-skills/harness
+cp -R plugins/harness/.claude-plugin plugins/harness/skills /tmp/harness-skills/harness/
+(cd /tmp/harness-skills && zip -r harness-skills.zip harness)
+```
+
+One top-level folder with `.claude-plugin/plugin.json` (the portal converts it to `.codex-plugin/plugin.json`) and
+`skills/harness/SKILL.md`; no `.mcp.json` or `mcp.json`. Safety scans can take two hours.
+
+| Field | Limit | Value |
+|---|---|---|
+| Display name | 30 | Harness |
+| Short description | 30 | Run coding agents in parallel |
+| Long description | 4,000 | the long text above |
+| Category | list | Developer Tools |
+| Capabilities | 20, 120 each | Start Claude Code or Codex on a task in a folder of its own · Wait for one or several agents and read their answers · Send a follow-up to an agent it started · Close agents once done; the person can resume them |
+| Starter prompts | 3, 128 each | Have Codex review this branch and give me the findings · Fix the api and ui tests in parallel, one agent each · Start an agent on the docs and tell me when it is done |
+| Logo | square, 48 px or more | `desktop/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png` |
+
+The skill runs the `harness` CLI from a shell, so it is useful where the agent has one (Codex), not in ChatGPT's
+chat alone.
+
+## 10. Lists
+
+Open these as a person, from a personal GitHub account; none needs the owner's login unless noted.
+
+**punkpeye/awesome-mcp-servers** (pull request to README.md; after Glama lists the server, because its check wants
+the Glama score badge on every new line). Section **🤖 Coding Agents**, in alphabetical order. Use the badge URL
+Glama shows on the listing; the slug below is a guess. Title: `Add autonomous-ai/openharness`, without the
+fast-track marker its CONTRIBUTING offers automated agents.
+
+```
+- [autonomous-ai/openharness](https://github.com/autonomous-ai/openharness) [![autonomous-ai/openharness MCP server](https://glama.ai/mcp/servers/autonomous-ai/openharness/badges/score.svg)](https://glama.ai/mcp/servers/autonomous-ai/openharness) 📇 🏠 🍎 🐧 - Run Claude Code and Codex agents in tmux sessions the person can watch: start, wait for, read and close them over MCP or the CLI.
+```
+
+**wong2/awesome-mcp-servers** (no pull requests; the form at mcpservers.org/submit):
+
+| Field | Value |
+|---|---|
+| Server Name | Harness |
+| Category | Development |
+| Short Description | Start Claude Code and Codex agents the person can watch, wait for them and read their answers. |
+| Repository, Website or Documentation | `https://github.com/autonomous-ai/openharness` |
+| Official MCP Registry Name | `io.github.autonomous-ai/harness` (after step 1) |
+| Supports remote connections | unchecked |
+| Contact Email | the submitter's; not written here |
+| Plan | Free (review within two weeks) |
+
+**hesreallyhim/awesome-claude-code** (the web issue form only, filed by a person: not with `gh`, not by an agent).
+It takes a repository with 14 days of active development since its first commit, or 100 stars; this one qualifies
+on the first. One line, no emoji, one resource at a time.
+
+| Field | Value |
+|---|---|
+| Title | `[Resource]: Harness` |
+| Display Name | Harness |
+| Category | Agent Orchestration |
+| Link | `https://github.com/autonomous-ai/openharness` |
+| Author Name | Autonomous |
+| Author Link | `https://github.com/autonomous-ai` |
+| Description (10–500 characters, 1–3 sentences, not addressed to the reader) | Runs Claude Code and Codex in tmux sessions, called harnesses, that the person can watch and join from a desktop, web or phone app. Its Claude Code plugin adds a skill and an MCP server with which Claude starts harnesses, waits for them, reads their answers and closes them. |
+| Checklist | the five required boxes; leave the last box unchecked, as it says |
+
+**VoltAgent/awesome-agent-skills** (pull request). It turns away skills that are days old, so wait some weeks.
+Append at the end of **Development and Testing**; the description is 10 words at most. Title:
+`Add skill: autonomous-ai/harness`.
+
+```
+- **[autonomous-ai/harness](https://github.com/autonomous-ai/openharness/tree/main/plugins/harness/skills/harness)** - Runs Claude Code and Codex agents the person can watch
+```
+
+**davila7/claude-code-templates** (aitmpl.com; pull request touching only `cli-tool/components/`; its CI runs
+`claude plugin validate` and security scans). Add `cli-tool/components/mcps/devtools/harness.json`:
+
+```json
+{
+ "mcpServers": {
+ "harness": {
+ "description": "Start Claude Code and Codex agents the person can watch, wait for them and read their answers. Runs the Harness CLI's MCP server; install the CLI with: curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash",
+ "command": "npx",
+ "args": ["-y", "@autonomous-ai/harness-mcp"]
+ }
+ }
+}
+```
+
+The npx form, as every example there uses a command a template can name; it answers with `harness_setup` until the
+CLI is installed. Skills there are copies (`cli-tool/components/skills/<category>/<name>/SKILL.md`) that would go
+stale, so the skill is left out.
+
+**davepoon/buildwithclaude** (pull request adding one entry to its `.claude-plugin/marketplace.json`; external
+plugins are referenced, not copied). Branch `add-harness`, title `Add harness plugin`, body sections Summary /
+Component Details (Name harness, Type plugin, Category orchestration) / Testing / Examples. Pin `sha` to a commit on
+`main`:
+
+```json
+{
+ "name": "harness",
+ "description": "Start, wait for, read and close Claude Code and Codex agents the person can watch, through Harness: the harness skill and its MCP server.",
+ "category": "orchestration",
+ "source": {
+ "source": "git-subdir",
+ "url": "https://github.com/autonomous-ai/openharness.git",
+ "path": "plugins/harness",
+ "sha": "<commit on main>"
+ }
+}
+```
+
+**RoggeOhta/awesome-codex-cli** (pull request, or an issue, which its maintainer works through in batches). Append
+to **Cross-Agent Tools**, with the star badge it requires. Title: `Add openharness to Cross-Agent Tools`.
+
+```
+- [autonomous-ai/openharness](https://github.com/autonomous-ai/openharness) - Runs Codex and Claude Code in tmux sessions the person can watch; its Codex plugin and MCP server let Codex start, wait for and read other agents. ![GitHub stars](https://img.shields.io/github/stars/autonomous-ai/openharness?style=flat-square)
+```
+
+**appcypher/awesome-mcp-servers**: archived; it takes no submissions.
+
+## 11. Listed without a submission
+
+- **skills.sh** ranks skills by the `skills` CLI's anonymous installs; there is no form. The repository has 96
+ `SKILL.md` files, so name the one: `npx skills add autonomous-ai/openharness --skill harness`. (It is found by the
+ CLI's recursive search, as the marketplace declares no skill paths.) Badge: `https://skills.sh/b/autonomous-ai/openharness`.
+- **PulseMCP**, and, by GitHub's announcement, **GitHub's MCP Registry**, from the Official MCP Registry (GitHub's:
+ **unverified** that it is live). Where VS Code's MCP gallery comes from: **unverified**.
+- **claudemarketplaces.com**: updated automatically (**unverified**).
+- **cursor.directory**: answered 429 to every request; **unverified**.
+
+## In order
+
+1. Merge this branch. Monday: release the CLI; publish `@autonomous-ai/harness-mcp` (**Owner**); deploy
+ `/agents` and `/llms.txt`.
+2. Same day: `make mcpb`, upload the asset, check its sha256; publish to the Official MCP Registry (**Owner**).
+3. Anthropic's directory, Cursor's marketplace, OpenAI's (skills only) and Smithery (**Owner**).
+4. Glama: add, claim, Dockerfile; then punkpeye's list with the badge, and mcpservers.org.
+5. The other lists: awesome-claude-code, awesome-codex-cli, claude-code-templates and buildwithclaude now;
+ awesome-agent-skills in a few weeks.
+
+Sources read on this date, beside the checklist's: github.com/modelcontextprotocol/mcpb (MANIFEST.md, schemas,
+`src/cli/pack.ts`, `src/node/validate.ts`); github.com/modelcontextprotocol/registry (docs/reference, package
+types, authentication, `internal/validators`); static.modelcontextprotocol.io/schemas/2025-12-11; cursor.com/docs
+(plugins reference, MCP install links, deeplinks) and cursor.com/marketplace/publish;
+code.visualstudio.com/docs/copilot (MCP developer guide, MCP configuration reference); lmstudio.ai/docs/app/mcp/deeplink;
+goose's docs (getting-started/using-extensions); smithery.ai/docs (publish, CLI, namespaces, update a server);
+glama.ai (add-server form, methodology, `glama.json` schema); claude.com/docs (plugins/submit, MCPB);
+developers.openai.com/plugins (submission); skills.sh/docs and github.com/vercel-labs/skills; and the README,
+contributing rules and checks of each list above.
diff --git a/docs/research/2026-10-11-where-to-list-harness.md b/docs/research/2026-10-11-where-to-list-harness.md
index 2842a0fa5..681d85fec 100644
--- a/docs/research/2026-10-11-where-to-list-harness.md
+++ b/docs/research/2026-10-11-where-to-list-harness.md
@@ -11,11 +11,26 @@ Codex both install; [harness.autonomous.ai/agents](https://harness.autonomous.ai
server is local only: it needs the CLI from `curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash`, with no
npm or PyPI package and no remote HTTPS endpoint.
+**The files these listings need are now in the repository**, and the text and commands for each submission are in
+[2026-10-11-listing-submissions.md](2026-10-11-listing-submissions.md):
+
+| For | File |
+|---|---|
+| Official MCP Registry | `server.json` (placeholders; `make mcpb` writes the one to publish) |
+| `.mcpb` bundle (Claude Desktop, the registry, Smithery) | `cli/packages/harness-mcp/mcpb/manifest.json`, built by `make mcpb ARGS="<version>"` |
+| npm (`npx -y @autonomous-ai/harness-mcp`) | `cli/packages/harness-mcp/` (#1189; published by hand, `cli/RELEASE.md`) |
+| Cursor | `.cursor-plugin/marketplace.json`, `plugins/harness/.cursor-plugin/plugin.json`, `plugins/harness/mcp.json` |
+| Glama | `glama.json`, `cli/docker/harness-mcp/Dockerfile` |
+| Editors' install links | `/agents`, "Add it to a client" |
+
+`website/scripts/listings.spec.ts` checks them against the registry's and MCPB's schemas.
+
## The one missing piece
Most MCP directories install a server from a package. An **`.mcpb` bundle** on a GitHub release (a small server
manifest whose command is `harness mcp`, and which says the CLI must be installed) unlocks the Official MCP
-Registry, Smithery, and PulseMCP after it. An npm package with `mcpName` would also do, as a wrapper only.
+Registry, Smithery, and PulseMCP after it. An npm package with `mcpName` would also do, as a wrapper only. Both are
+now built (above); what is left is the release that carries `harness mcp`, the upload and the publishing.
## Checklist
@@ -57,7 +72,8 @@ may be held as close to an existing listing (**unverified**).
Needs first: the package. For `mcpb`: an https release asset on github.com whose URL contains "mcp" (for example
`/autonomous-ai/openharness/releases/download/<tag>/harness-mcp.mcpb`) and its `fileSha256`. A metadata-only entry
-may be accepted (**unverified**) but no client could install it. Does not qualify today.
+may be accepted (**unverified**) but no client could install it. Does not qualify today. Now: `server.json` lists the
+npm package and the `.mcpb`; both exist once the CLI with `harness mcp` is released and the npm package published.
### 4. Smithery (smithery.ai)
@@ -67,6 +83,7 @@ may be accepted (**unverified**) but no client could install it. Does not qualif
3. Settings → Verification for the vendor checklist.
Needs first: the same `.mcpb`, and a Smithery namespace (how one is made: **unverified**). Does not qualify today.
+Now: `make mcpb` builds the bundle; it is the only form Smithery takes for a local server (no npm).
### 5. PulseMCP (pulsemcp.com)
@@ -80,10 +97,11 @@ MCP Registry, so item 3 covers it.
`plugins/harness/.cursor-plugin/plugin.json` (only `name` is required), a root `.cursor-plugin/marketplace.json`
pointing at `plugins/harness`, and `plugins/harness/mcp.json` with
`{"mcpServers":{"harness":{"command":"harness","args":["mcp"]}}}`. Test from `~/.cursor/plugins/local/harness` and
- **Developer: Reload Window**. Cursor's docs do not say whether it reads `.claude-plugin`.
+ **Developer: Reload Window**. Cursor's docs do not say whether it reads `.claude-plugin`. Now: all three files are
+ in the repository.
- **Add to Cursor link**, no submission: `cursor://anysphere.cursor-deeplink/mcp/install?name=harness&config=eyJjb21tYW5kIjoiaGFybmVzcyIsImFyZ3MiOlsibWNwIl19`
- (the config is base64 of `{"command":"harness","args":["mcp"]}`). It could go on `/agents` once `harness mcp` is
- released.
+ (the config is base64 of `{"command":"harness","args":["mcp"]}`). Now on `/agents`, beside VS Code's, LM Studio's
+ and goose's.
- **cursor.directory**: answered 429 to every request; **unverified**.
### 7. Glama (glama.ai/mcp/servers)
@@ -95,6 +113,8 @@ MCP Registry, so item 3 covers it.
Needs first: the Dockerfile (install the CLI, then `harness mcp`), `glama.json`, and `harness mcp` answering
initialize and tools/list with no daemon or tmux running (not checked). How the score is computed: **unverified**.
+Now: `glama.json` and `cli/docker/harness-mcp/Dockerfile` are in the repository, and `harness mcp` was checked to
+answer initialize and tools/list with no daemon and no tmux, from the sources and in that image.
A passing Glama listing is what the largest awesome list (item 9) asks for.
### 8. Skills and OpenAI's plugin directory
@@ -133,6 +153,8 @@ A passing Glama listing is what the largest awesome list (item 9) asks for.
## In order
+The submissions page repeats this order with the exact text and commands for each step.
+
1. Merge this branch and the `harness mcp` change; release the CLI; deploy `/agents` and `/llms.txt`.
2. Anthropic's directory and OpenAI's (skills only): no new files.
3. The `.mcpb` release asset and `server.json`; choose the namespace (an organization Owner for
diff --git a/glama.json b/glama.json
new file mode 100644
index 000000000..fde4a5c15
--- /dev/null
+++ b/glama.json
@@ -0,0 +1,4 @@
+{
+ "$schema": "https://glama.ai/mcp/schemas/server.json",
+ "maintainers": ["deehw"]
+}
diff --git a/plugins/harness/.cursor-plugin/plugin.json b/plugins/harness/.cursor-plugin/plugin.json
new file mode 100644
index 000000000..986e8eb27
--- /dev/null
+++ b/plugins/harness/.cursor-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+ "name": "harness",
+ "description": "Start Claude Code, Codex and other coding agents as harnesses the person can watch, then wait for them, read their answers and close them. Uses the Harness CLI.",
+ "author": {
+ "name": "Autonomous"
+ },
+ "homepage": "https://harness.autonomous.ai/agents",
+ "repository": "https://github.com/autonomous-ai/openharness",
+ "license": "MIT",
+ "keywords": ["agents", "parallel", "codex", "claude-code", "orchestration", "tmux", "mcp"],
+ "logo": "assets/logo.svg"
+}
diff --git a/plugins/harness/README.md b/plugins/harness/README.md
index 338773529..b49df7a91 100644
--- a/plugins/harness/README.md
+++ b/plugins/harness/README.md
@@ -1,4 +1,4 @@
-# Harness plugin for Claude Code and Codex
+# Harness plugin for Claude Code, Codex and Cursor
Lets a coding agent use [Harness](https://harness.autonomous.ai/agents): start Claude Code, Codex and other agents
as harnesses the person can watch, wait for them, read their answers, message them and close them.
@@ -7,7 +7,8 @@ It holds two things:
- `skills/harness/SKILL.md`: the `harness` skill, in the [Agent Skills](https://agentskills.io) format. When to use
Harness instead of your own sub-agents, the commands, and the rules.
-- `.mcp.json`: Harness's MCP server, `harness mcp` over stdio.
+- `.mcp.json` (Claude Code, Codex) and `mcp.json` (Cursor): Harness's MCP server, `harness mcp` over stdio. The two
+ say the same.
Both need the Harness CLI on the agent's `PATH`:
@@ -39,11 +40,19 @@ repository; Codex reads the same file. `--sparse` checks out only the marketplac
and `/plugin install harness@openharness` do the same, cloning the whole repository. Any other agent that reads `SKILL.md` can take the skill alone: copy
`skills/harness/` into its skills folder (`~/.agents/skills/` for Codex, `~/.claude/skills/` for Claude Code).
+Cursor reads this folder through [`.cursor-plugin/marketplace.json`](../../.cursor-plugin/marketplace.json) and
+`.cursor-plugin/plugin.json` here. It is not in Cursor's marketplace yet. To load it locally, copy this folder to
+`~/.cursor/plugins/local/harness` (Cursor skips a symbolic link to a folder elsewhere), then run **Developer: Reload
+Window**.
+
## Changing it
The skill describes commands agents run as written, so change it with the CLI (`cli/src/agentClient/`,
`cli/src/lib/newCommand.ts`) and with the pages that say the same: `website/public/agents/index.html` and
-`website/public/llms.txt`. Check the plugin with `claude plugin validate .` from the repository root.
+`website/public/llms.txt`. Check the plugin with `claude plugin validate .` from the repository root;
+`website/scripts/agents-site.spec.ts` and `website/scripts/listings.spec.ts` check the rest, including that the two
+MCP files agree. Where Harness is listed, and what each directory reads, is in
+[docs/research/2026-10-11-listing-submissions.md](../../docs/research/2026-10-11-listing-submissions.md).
The plugin has no `version`, so an install tracks the commit it came from and `claude plugin update` picks up
changes on `main`.
diff --git a/plugins/harness/assets/logo.svg b/plugins/harness/assets/logo.svg
new file mode 100644
index 000000000..212fe2233
--- /dev/null
+++ b/plugins/harness/assets/logo.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0"?><svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="54 54 916 916" fill="none"><!-- The mark, 400x400 as the design ships it (docs/branding/app-logo/harness-logo-4.svg), fitted into the 916px box this icon set
+ has always used: 54px of margin on every side is what keeps macOS from clipping the corners of its own squircle.
+ Every app icon, desktop and mobile, is rendered from this file: docs/branding/app-logo/render-app-icon.swift.
+ This revision carries no clip path: its own rounded tile is the first element and nothing is drawn outside it. --><g transform="translate(54 54) scale(2.29)"><rect width="400" height="400" rx="60" fill="url(#paint0_linear_6337_1342)"></rect><circle cx="200.5" cy="199.5" r="179.5" stroke="#030303" stroke-width="2.2"></circle><rect x="53.6719" y="84.3828" width="292.663" height="294.614" stroke="#030303" stroke-width="2.2"></rect><path d="M190.828 86.3429C192.453 85.6517 194.989 84.9255 196.686 85.6787C196.662 86.0764 196.293 86.0695 195.704 86.3026C193.226 87.2843 192.075 87.8801 190.283 89.8564C191.294 89.3018 193.795 88.1995 194.876 88.8126C194.163 89.1266 193.929 89.1724 193.393 89.715C193.63 90.4308 194.667 89.9582 195.526 90.979L195.346 91.131C190.876 91.7552 190.474 93.7609 190.092 97.7179C189.633 98.1138 189.384 98.2892 189.032 98.7988L189.185 98.9181C191.906 97.4096 190.71 92.3411 195.357 92.6142C196.489 92.6809 198.277 93.3099 199.06 94.1173C198.769 95.2806 195.798 94.7859 194.914 96.2532C194.814 97.4014 195.68 98.3361 196.351 99.2899C195.207 100.243 194.237 101.396 192.954 102.458C196.022 102.506 195.802 102.636 198.55 103.5C198.961 103.342 199.209 103.192 199.64 103.268C199.866 104.619 199.554 108.296 199.705 109.947C199.768 110.635 199.387 111.365 199.607 112.36C200.644 113.501 201.523 112.366 202.83 112.896C203.083 113.337 203.003 113.095 202.946 113.671C202.135 114.872 201.325 113.296 200.971 115.669L200.892 115.937L201.46 116.027C202.684 116.621 203.791 116.713 204.735 117.28C204.939 117.906 204.956 117.62 204.814 118.164C202.886 117.926 200.541 117.596 198.632 117.833L198.554 118.059C199.469 118.497 202.115 118.279 202.471 118.94L202.222 119.818C201.427 120.46 199.655 120.202 198.342 120.917C197.724 121.748 198.325 122.31 199.069 122.792C199.619 122.736 199.57 122.601 200.079 122.093C201.918 121.599 200.96 125.033 204.737 122.934C209.991 120.013 210.159 119.656 210.437 113.386C209.336 114.02 209.023 114.276 208.05 115.107C209.059 110.332 211.855 112.231 210.706 106.108C207.094 107.81 208.563 106.216 207.229 105.994C206.837 106.818 206.906 106.771 206.189 107.267L205.915 107.453C206.25 107.85 206.288 107.881 206.526 108.339C205.412 109.343 203.604 108.045 202.696 107.331C202.4 107.411 202.393 107.472 202.164 107.678C201.663 106.669 200.803 103.856 201.065 102.768L201.282 102.694C204.208 104.091 205.286 100.984 209.811 103.83C209.09 101.77 208.837 101.152 209.256 98.9643C208.479 97.0926 208.166 96.634 206.971 94.9951C207.203 94.5322 207.408 94.4931 207.867 94.2722C208.886 93.7813 209.622 96.3668 210.749 96.9468L210.964 96.7228C211.435 94.036 208.748 92.8908 208.715 91.4981L209.018 91.2775C211.6 91.1193 211.932 92.288 213.029 94.3909C212.897 93.7654 212.844 93.3149 212.771 92.677L212.935 92.6187C213.402 93.046 213.609 93.6793 213.901 94.2951C214.286 94.289 214.093 94.3364 214.459 93.9714C214.871 92.1917 214.01 91.1463 212.666 90.2566C211.599 90.176 210.398 90.1555 209.319 90.1126C210.412 89.4004 211.188 88.8717 212.531 88.8795C214.974 88.8937 216.468 90.9863 216.362 93.3854L216.138 93.5819L215.48 93.2801L215.315 93.3714C215.425 94.2894 216.195 94.7974 216.453 95.5907C217.004 97.2933 216.383 99.0045 219.046 98.5899C219.617 98.5011 219.828 98.2057 220.117 97.6933C220.151 97.1052 220.156 97.055 219.877 96.5486L219.722 96.2563L219.597 96.0287C219.87 95.9321 220.069 95.8914 220.327 96.1208C223.695 99.1208 220.452 100.346 219.514 101.874C220.46 103.596 219.775 103.026 219.682 104.392C219.552 106.319 223.868 105.553 224.865 107.755C225.528 109.223 225.836 109.832 225.514 111.574C225.347 112.708 223.859 114.678 222.617 114.41L222.494 114.196C224.119 112.38 224.406 110.619 221.659 109.786L221.517 109.928C222.26 112.355 221.759 112.854 220.173 114.671C220.748 115.591 221.292 116.646 222.279 117.08L222.473 116.96C222.568 116.449 222.675 115.939 222.795 115.434L223.031 115.423C225.869 118.959 222.301 124.258 219.994 123.139C219.799 122.604 220.789 122.396 221.232 121.283C221.127 120.549 221.271 120.86 220.799 120.311C218.153 119.288 219.154 122.713 218.073 123.878C217.821 124.148 217.691 124.477 217.674 124.84C218.399 125.649 219.28 124.972 219.906 124.449C220.18 125.448 220.566 127.085 220.291 128.068C219.706 130.151 217.715 131.586 215.641 131.041L215.55 130.81C216.337 130.281 217.33 129.973 217.426 128.971C216.997 128.286 216.063 128.187 215.339 128.107C214.209 127.983 214.847 129.524 214.616 130.224C214.474 130.657 214.055 132.965 213.756 133.294C216.602 134.665 219.768 135.994 222.699 137.379C232.105 131.93 235.719 132.04 246.171 133.166C250.26 130.834 253.052 128.335 257.979 126.599C262.122 125.14 269.42 122.825 273.616 124.795L273.65 124.995C272.682 125.269 270.378 125.186 269.125 125.375C263.612 125.761 259.852 130.874 255.594 132.859C249.472 135.709 248.659 134.58 244.38 140.709C246.296 140.102 248.235 139.3 250.106 138.744C253.777 137.652 256.842 136.779 260.372 135.175C266.643 132.326 268.598 128.486 275.489 127.313L273.973 129.288C274.639 129.216 275.301 129.113 275.956 128.98C280.225 128.086 282.926 125 285.205 121.406C280.818 121.988 275.508 123.087 271.232 123.427C273.257 121.301 275.46 119.025 277.796 117.287C284.679 112.072 293.395 111.333 301.146 108.147C303.072 107.356 304.897 106.441 306.732 105.458C308.744 104.381 310.692 103.191 312.816 102.373C307.779 108.865 301.962 108.776 296.013 113.308C294.084 114.779 291.712 118.561 290.308 120.661C293.964 119.536 295.943 118.397 299.181 116.435C303.934 113.555 311.787 105.536 317.368 106.035C323.298 102.632 321.765 100.394 325.134 95.744C325.653 94.424 329.872 93.8645 330.308 93.2217C331.569 91.3579 339.189 87.4062 341.241 87.9786C341.63 88.0892 341.941 88.3896 342.071 88.7811C342.948 91.3801 332.695 93.2388 331.213 95.6858C332.414 96.0613 340.894 90.2761 342.403 92.8804C342.36 95.7781 332.399 97.2944 331.441 99.3808C332.38 99.8037 337.473 96.6068 339.584 96.7753C340.097 97.1101 339.895 96.8912 340.176 97.4921C339.921 99.5849 332.843 102.057 331.03 102.408C328.619 105.651 325.157 108.872 321.105 109.5C319.417 109.761 317.891 109.831 316.42 110.791C308.475 115.973 302.429 123.67 294.065 128.282C292.104 129.364 290.337 130.257 288.207 130.977C286.854 131.434 285.199 131.818 283.9 132.305C282.611 132.789 281.568 133.807 280.021 134.146C277.991 134.592 275.644 134.482 273.744 135.308C270.257 136.826 267.352 139.472 264.07 141.51C269.774 142.746 273.128 143.912 278.725 141.8C280.623 141.084 284.157 140.787 286.208 140.804C290.908 140.844 295.57 142.18 300.182 142.989C305.354 143.882 310.504 143.485 315.686 142.957C318.647 142.655 320.609 141.1 323.334 140.092C324.662 139.376 326.838 140.057 328.066 139.746C330.093 139.146 331.444 139.13 333.536 139.508C334.838 139.744 335.828 139.004 336.953 140.044C337.018 140.409 337.116 140.714 336.832 141.017C335 142.965 332.296 142.309 330.584 140.937C328.742 141.102 326.469 140.861 324.798 141.239C322.651 141.725 318.83 144.137 316.784 144.481C312.153 145.26 307.013 145.57 302.359 146.106C306.084 147.249 309.57 148.089 313.447 148.427C314.665 148.533 317.975 149.577 318.955 149.055C318.534 148.662 318.58 148.85 318.462 148.409C319.92 147.901 321.252 147.652 322.591 146.776C324.259 145.683 325.697 143.795 327.627 143.216C331.225 142.137 333.124 144.044 336.741 142.308C338.371 142.658 344.445 144.154 345.12 145.478C345.108 146.205 345.215 145.89 344.807 146.465C342.868 147.43 339.112 145.559 336.959 145.335C335.737 145.208 334.396 145.291 333.172 145.345C335.407 146.069 346.008 147.179 345.321 150.452C343.653 152.421 335.929 147.928 333.575 148.418C333.341 148.467 333.3 148.65 333.178 148.839L333.319 149.09C335.228 149.298 342.729 151.427 343.403 153.281C343.314 153.671 343.258 153.858 342.9 154.098C341.399 155.107 334.068 151.563 331.839 151.388L331.54 151.79C332.523 152.722 338.407 153.55 339.199 155.549C339.09 155.954 339.177 155.871 338.912 156.159C337.99 157.157 332.636 154.945 331.449 154.483C328.047 153.161 326.44 154.597 322.834 154.436C320.395 154.488 317.669 152.323 315.353 152.461C305.932 153.026 296.976 157.711 287.525 157.997C285.099 158.086 282.672 157.896 280.288 157.429C277.936 156.961 275.152 156.139 272.843 156.105C267.236 156.024 262.69 158.251 256.943 158.481C254.029 158.62 251.107 158.435 248.23 157.932C246.135 157.564 242.598 156.765 240.6 156.706L240.347 156.7C237.898 161.147 234.701 163.833 232.144 167.16C231.097 168.525 229.447 176.687 228.436 179.21C226.495 184.05 223.201 192.288 224.37 197.514C224.636 199.293 226.229 202.413 226.25 204.099C226.294 208.022 226.459 210.152 227.808 213.879C228.715 216.379 229.192 218.635 230.584 221.088C232.206 223.999 234.426 226.838 236.495 229.42C242.656 237.103 247.382 244.949 249.2 254.903C250.03 259.438 250.498 264.805 252.544 268.9C253.55 270.915 255.765 272.53 256.9 274.491C257.978 276.056 258.66 279.442 259.984 280.696C263.915 284.421 267.99 287.018 270.963 291.816C277.067 301.671 277.086 314.624 282.748 324.468C283.895 326.46 285.878 325.93 286.483 329.67C290.075 331.104 299.515 337.507 301.148 341.341C302.687 343.339 300.96 344.731 300.98 345.144C301.085 347.154 302.749 347.511 299.345 349.186C298.644 350.118 299.586 350.878 298.422 351.749C297.519 352.427 297.236 352.09 296.236 351.947C295.446 352.894 295.644 354.863 293.915 355.013C291.156 355.25 289.244 353.654 287.574 351.628C286.584 350.427 285.772 349.517 285.077 348.109C283.875 345.669 282.97 343.069 281.405 340.841C280.021 338.873 276.623 338.211 276.544 335.344C276.506 334.364 276.453 333.885 275.641 333.25C274.642 332.479 274.74 331.299 274.517 330.16C274.071 327.082 272.193 324.382 270.376 321.973C268.208 319.097 265.589 316.007 262.847 313.672C259.811 311.088 256.348 310.061 254.006 306.664C251.217 302.884 250.155 298.649 248.843 294.153C248.403 292.646 247.712 290.206 246.951 288.912C245.682 286.755 243.15 286.068 241.43 283.949C240.255 282.513 239.516 280.692 238.358 279.247C237.595 278.394 236.649 277.604 235.768 276.87C231.665 273.454 229.584 268.628 225.976 264.712C224.569 270.701 221.969 277.704 220.83 283.648C220.411 285.829 220.984 288.268 220.811 290.494C220.614 293.024 219.896 295.701 220.279 298.273C221.786 305.376 224.08 311.783 223.366 319.353C222.376 329.834 217.602 342.178 216.191 352.563C215.791 355.507 216.771 356.978 216.946 359.74C216.942 359.805 216.939 359.87 216.935 359.935C221.668 362.408 222.911 365.553 227.168 368.062C228.212 368.676 229.927 368.655 231.08 369.083C232.575 369.64 233.984 369.682 234.725 371.089C234.942 371.501 234.983 372.202 234.744 372.584C233.403 374.726 230.278 375.698 228.409 376.239C227.943 376.374 226.644 377.014 226.17 376.919C223.919 376.468 219.699 376.134 217.734 375.174C216.22 374.435 215.215 373.156 213.403 372.842C211.057 372.435 208.859 373.014 206.594 372.475C205.623 372.245 204.634 371.555 204.189 370.64C202.943 368.081 205.145 364.887 205.339 362.249C205.421 361.129 204.698 359.213 204.922 358.223C205.154 357.199 205.917 355.897 206.215 354.647C207.463 349.424 206.823 336.915 205.595 331.715C204.78 328.256 202.879 325.91 202.773 321.221C202.664 316.44 203.363 313.626 204.494 309.068C204.974 307.132 205.573 303.828 205.607 301.879C205.672 298.163 203.17 294.855 203.015 290.966C202.814 285.973 204.306 278.907 204.113 273.886C203.878 267.783 201.8 262.147 201.2 255.955C201.065 254.57 200.6 245.071 200.526 244.933C199.936 244.817 200.105 244.735 199.671 244.91C199.424 246.09 199.494 247.826 199.424 249.108C199.284 251.54 199.046 253.964 198.716 256.378C198.39 258.599 197.984 260.808 197.5 262.997C196.823 265.931 195.804 269.251 195.766 272.242C195.694 277.936 196.857 284.409 196.311 290.252C196.279 293.865 193.171 298.328 193.52 301.779C194.121 307.712 197.355 313.459 197.156 319.782C197.016 324.258 195.985 326.997 194.939 331.26C194.324 333.767 194.772 338 194.765 340.653C194.916 343.609 195.472 351.883 196.941 354.509C197.733 355.924 198.462 357.002 199.011 358.61C199.437 359.853 198.72 361.644 198.845 362.389C199.332 365.308 199.722 365.421 199.416 368.461C200.649 370.422 201.308 371.634 201.216 374.041C201.125 376.409 200.694 377.399 198.505 378.077C196.32 378.753 195.762 377.285 194.442 377.196C192.487 378.691 192.669 377.858 190.716 377.305C189.571 377.708 189.524 377.713 188.346 377.387C186.894 376.983 186 377.016 184.628 376.263C184.391 375.787 183.961 374.969 183.779 374.478C182.679 371.507 185.279 369.632 186.627 367.394C187.203 366.437 187.601 365.271 187.984 364.251C187.699 363.774 186.993 362.541 186.942 362.071C186.611 358.577 187.798 355.933 186.527 352.427C181.603 338.849 173.271 322.022 176.796 306.819C177.448 304.009 178.064 299.82 178.522 296.94C178.932 295.022 177.943 292.246 178.116 290.422C178.474 286.445 179.113 280.044 177.824 276.126C176.514 272.144 175.388 268.606 174.397 264.484C171.604 267.79 169.576 271.115 166.885 274.467C165.821 276.129 162.376 278.071 161.459 279.511C159.544 282.52 158.429 284.825 155.083 286.548C154.185 287.139 152.817 287.831 152.272 288.798C149.262 294.144 148.801 300.145 144.757 305.087C142.361 308.393 139.029 310.273 136.084 312.893C132.076 316.457 127.982 321.553 126.105 326.71C125.092 329.492 125.825 331.647 123.627 333.824C122.885 338.685 120.925 337.769 118.28 341.032C116.799 342.86 115.872 346.833 114.426 348.852C112.907 350.973 110.596 354.291 107.966 354.884C105.613 355.262 104.212 354.344 104.015 351.912L103.76 351.825C101.615 352.522 100.947 351.693 100.886 349.46C100.871 348.924 99.2183 348.573 98.6701 347.649C98.9368 345.924 99.6265 346.127 98.355 344.421C97.8023 341.896 101.075 337.962 102.97 336.582C106.243 334.198 109.64 331.594 113.109 329.531C113.178 329.099 113.385 327.779 113.564 327.475C115.404 324.355 117.587 324.043 118.83 320.082C121.923 310.238 122.963 298.776 128.407 289.955C130.317 286.862 133.314 283.991 136.209 281.89C137.429 281.005 139.148 279.76 140.198 278.7C141.566 277.32 142.414 274.837 143.723 273.341C145.041 271.835 146.805 270.497 147.75 268.694C149.742 264.751 150.326 259.816 151.115 255.488C152.967 245.337 157.708 237.064 164.098 229.261C165.81 227.171 167.717 224.668 169.184 222.333C171.758 218.233 172.431 213.336 174.647 209.028C174.071 204.216 175.014 202.638 176.16 198.103C177.802 191.601 173.159 183.62 171.237 177.593C170.823 176.293 168.534 167.871 168.291 167.579C165.083 163.709 162.514 161.095 159.822 156.645C157.711 156.728 155.076 157.381 152.947 157.771C149.708 158.382 146.412 158.619 143.121 158.476C137.679 158.246 132.993 156.047 127.587 156.114C124.81 156.148 122.416 156.931 119.734 157.458C117.266 157.931 114.751 158.103 112.244 157.969C103.129 157.517 94.598 153.336 85.5593 152.451C82.66 152.168 80.6063 154.118 77.7436 154.408C75.1613 154.671 72.9672 153.693 70.4637 153.933C68.3987 154.202 62.9785 157.375 61.2088 156.125C60.9425 155.565 60.9835 155.857 61.1247 155.215C62.2204 153.894 65.1445 153.323 66.7644 152.454C66.9641 152.347 68.3278 152.158 68.8024 151.982L68.819 151.538C65.7868 151.117 59.1732 155.446 56.9232 153.869C56.2897 151.682 63.2499 150.126 64.8178 149.414C65.082 149.294 66.7263 149.438 67.3195 149.349L67.1452 148.873C64.9829 147.053 56.3278 152.987 54.6722 150.378C54.6544 150.167 54.5913 149.584 54.7175 149.449C57.1041 146.89 64.6173 146.05 67.1089 145.399C64.1172 145.11 61.9718 145.612 59.0818 146.374C57.95 146.673 55.807 147.146 54.9982 146.031C54.9776 145.751 54.9411 145.288 55.1812 145.119C56.7201 144.036 61.6778 142.766 63.3237 142.353C66.7744 143.919 69.236 142.122 72.8184 143.316C74.7049 143.945 75.8029 145.573 77.4621 146.658C78.9286 147.617 80.1594 147.82 81.7705 148.276L81.8052 148.463C81.3848 148.778 81.2933 148.758 81.091 149.2C82.4424 149.536 84.7834 148.478 86.1993 148.377C90.2077 148.093 93.6544 147.241 97.5187 146.131C93.6399 145.402 88.0224 145.433 83.8631 144.552C80.4706 143.834 77.8972 141.863 74.7034 141.115C74.1396 140.983 70.2028 141.078 69.3084 141.077C68.2222 141.805 67.1365 142.339 65.8113 142.226C64.6911 142.131 62.944 141.457 63.1628 140.046C63.9809 139.196 68.1416 139.567 69.4841 139.285C69.8867 139.2 72.1519 139.807 72.7638 139.817C73.9442 139.837 75.0883 139.453 76.213 139.894C80.4253 141.295 80.8865 142.705 85.5184 143.087C90.775 143.521 94.7175 143.939 100.098 142.989C104.852 142.149 109.106 140.924 113.979 140.835C116.209 140.792 118.435 141.042 120.603 141.578C122.546 142.07 125.608 143.08 127.513 143.113C131.293 143.179 131.752 141.257 135.721 142.77C132.978 143.449 129.302 144.536 126.572 144.647C124.83 144.717 122.225 143.856 120.522 143.401C115.668 142.106 111.712 142.955 107.053 144.312C109.837 144.985 113.461 145.662 115.576 147.753C117.784 149.935 119.249 152.537 122.866 152.097C123.592 152.008 125.726 151.285 126.167 150.708L125.75 150.275L125.841 150.119C132.793 147.318 136.08 147.193 143.397 149.081C146.054 149.767 147.89 150.053 150.576 149.506C149.01 147.74 148.215 147.272 146.206 145.955C152.385 144.856 155.705 145.776 161.683 147.561C160.724 146.293 159.743 145.026 158.45 144.094C152.899 140.094 143.807 141.56 137.598 142.521C133.869 140.271 130.139 136.912 126.372 135.23C123.853 134.106 120.273 134.981 117.441 133.004C116.341 132.236 113.281 131.49 111.844 130.956C108.685 129.782 105.953 128.364 103.13 126.471C96.205 121.828 90.6422 115.309 83.6801 110.722C82.2747 109.796 80.9333 109.858 79.3386 109.585C74.7808 108.806 71.8924 105.952 69.0725 102.478C67.1767 101.963 60.2555 99.552 60.0153 97.3787C61.1553 95.4758 67.1502 99.6203 68.3826 99.1546C65.791 96.9713 60.917 96.1329 58.1852 94.0581C57.7553 93.7317 57.6747 93.3701 57.6453 92.8894C57.9227 92.3485 57.9016 92.3872 58.4288 92.0944C60.6834 91.8326 67.328 95.2779 69.7051 96.2783C66.3524 93.419 62.7857 92.5912 59.0494 90.511C58.4342 90.1686 58.229 89.7976 58.1022 89.1291C58.47 87.6718 59.644 87.627 60.7958 88.0922C64.3342 89.5218 67.1498 90.3687 69.8442 93.1752C70.4656 93.8225 74.276 94.1898 75.2484 95.8098C77.2804 99.1962 77.685 102.791 81.193 105.067C83.123 106.325 85.0747 106.024 87.1213 106.904C89.3181 107.848 91.487 109.507 93.444 110.919C98.9292 114.995 103.275 118.707 109.934 120.648C106.207 114.829 103.642 111.789 97.2511 109.561C93.5209 108.261 89.7298 105.117 86.9983 102.199C90.5035 103.391 94.9376 106.527 98.672 107.985C112.491 113.382 117.858 111.435 128.627 123.255C125.102 122.224 118.837 118.876 115.227 119.631C113.998 120.697 116.181 123.197 116.936 124.172C119.335 127.266 122.174 128.898 126.017 129.274C125.519 128.652 125.051 127.978 124.585 127.329C131.731 128.582 133.63 132.483 140.064 135.332C143.624 136.909 146.846 137.781 150.516 138.893C152.086 139.368 154.101 140.207 155.688 140.794C155.473 140.866 155.254 140.939 155.024 141.015C157.299 140.758 160.221 140.272 162.237 141.618C164.062 142.837 164.642 145.948 166.142 147.979C168.473 151.137 171.597 152.576 174.061 155.287C176.206 157.647 176.874 161.124 179.802 163.218C181.828 164.768 183.676 165.852 186.182 166.382C187.775 166.718 191.49 166.166 192.046 168.291C192.125 168.591 191.961 169.193 191.699 169.395C189.491 171.093 186.68 171.064 184.05 171.025C183.391 171.016 182.696 172.032 182.898 172.753C183.617 175.318 185.843 177.277 187.856 178.815C194.119 177.278 190.504 180.261 192.479 183.49C195.367 188.213 197.616 192.56 195.558 198.348C194.995 199.93 193.823 202.799 194.031 204.527C194.385 207.469 196.845 210.152 196.826 213.303C196.849 217.592 195.794 223.256 190.84 218.242C188.116 215.489 186.353 211.399 186.33 207.454C186.309 203.596 186.762 202.084 184.181 199.004L184.016 198.808C179.139 206.906 181.146 206.441 185.051 213.394C185.4 214.015 187.035 220.177 187.43 221.413C186.132 220.075 183.872 216.894 182.462 216.032C179.858 214.438 179.001 214.535 176.392 212.403C176.199 212.958 176.039 213.523 175.911 214.097C175.282 217.031 176.617 220.886 176.496 224.076C176.376 227.255 175.789 230.094 175.49 233.23C174.546 243.105 175.548 252.772 180.807 261.306C181.457 255.297 184.226 249.787 187.859 245.105C185.983 252.149 183.698 260.829 187.825 267.383C192.005 274.019 194.224 281.278 190.048 288.81C189.088 287.337 188.146 285.029 186.927 283.118C186.551 286.321 185.52 287.102 184.504 289.948C184.257 290.641 185.002 292.407 185.036 293.206C185.085 294.414 184.859 295.657 184.868 296.868C184.835 298.038 185.059 300.433 184.903 301.437C184.25 305.645 182.525 309.281 182.737 313.854C183.003 319.587 186.379 323.31 187.601 328.827C188.482 332.801 188.332 336.666 189.013 340.649C189.926 345.986 191.464 355.039 192.189 360.447C188.853 364.532 190.959 366.6 188.004 370.443C187.175 371.521 185.106 371.458 184.893 373.284L185.15 373.607C185.847 373.414 186.051 371.915 187.113 371.788C187.247 372.664 185.919 374.16 186.738 375.515L187.187 375.598C188.112 375.045 187.812 371.679 189.543 371.855C189.887 373.04 187.852 374.727 189.397 376.209L189.7 376.149C190.62 375.07 190.762 372.074 191.888 371.606C192.785 372.153 191.401 375.491 191.993 375.96C194.626 378.044 193.155 370.784 195.953 371.774C196.257 372.661 195.543 373.902 195.744 374.88C196.013 376.186 198.06 376.068 198.987 375.714C200.001 374.662 199.372 373.86 198.785 372.749L199.011 370.891C197.405 367.777 197.371 366.565 196.976 363.201C196.892 362.483 195.523 360.814 195.976 360.094L197.105 360.275C197.981 359.27 195.418 355.471 194.813 354.237C194.344 353.28 193.972 352.278 193.704 351.244C192.539 346.89 191.989 338.665 192.153 334.16C192.256 331.351 192.478 329.046 192.329 326.234L193.151 327.798C197.57 317.49 192.621 311.52 191.636 302.069C190.878 303.868 190.364 306.182 189.774 308.054C189.317 305.919 189.558 302.432 189.538 300.129L190.007 300.154C190.643 299.709 191.308 298.324 191.708 297.639C193.522 294.535 194.195 291.703 194.083 288.104C193.554 288.666 192.673 289.73 191.988 289.878C191.861 289.201 194.117 283.861 194.112 282.395C194.09 277.088 192.577 269.957 192.664 264.679C193.314 265.768 193.486 266.092 193.933 267.288C194.949 263.819 195.887 259.484 195.423 255.873C194.308 247.207 191.737 245.727 194.397 236.91C193.577 233.56 191.972 232.407 190.245 229.533C189.453 228.212 189.076 227.32 188.505 225.881C191.573 228.541 194.524 230.533 198.497 231.049C198.726 231.013 199.667 231.681 199.657 231.903C199.554 233.832 197.17 240.153 200.58 240.535C203.117 240.82 201.207 233.563 203.449 232.392C204.533 231.825 208.732 229.057 209.905 229.046C210.176 232.361 211.616 233.781 213.176 236.59C216.619 242.789 218.384 251.062 217.038 258.109C215.666 254.261 215.186 252.695 212.96 249.27C210.797 257.295 214.845 259.802 214.147 267.325C213.764 271.456 211.106 276.238 209.982 280.016C208.973 283.406 210.355 285.554 211.91 288.359L211.373 290.411C211.65 291.187 212.31 292.569 212.483 293.257C213.602 297.71 214.351 302.609 212.81 307.046C212.122 309.026 211.38 311.567 211.132 313.568C210.718 316.892 211.428 319.966 211.813 323.249C212.083 321.232 212.798 317.748 213.571 315.907C214.151 321.741 214.71 327.749 213.884 333.609C212.799 341.321 211.009 351.809 210.528 359.625C210.492 360.196 209.49 362.27 209.287 363.01C208.481 365.93 209.767 364.743 211.688 364.993C212.552 365.16 213.451 365.567 214.202 365.972C216.629 367.286 217.32 370.039 219.248 371.799C220.484 372.928 222.73 372.761 224.076 373.766C225.013 374.466 226.206 374.573 227.324 374.387C227.836 374.292 227.967 374.187 228.205 373.822C227.594 372.366 224.914 372.57 224.119 371.134C225.651 368.929 229.729 374.089 230.601 374.498C231.26 374.45 230.995 372.676 231.453 372.265C231.265 370.706 228.328 371.638 227.675 370.827L228.173 370.642C230.039 370.869 231.417 371.111 232.777 372.119L233.295 371.994L233.333 371.67C231.369 368.546 227.01 369.714 224.471 367.905C221.157 365.546 218.622 362.494 215.11 360.044C211.642 346.981 221.085 329.943 221.261 317.139C221.283 315.613 221.194 314.088 220.996 312.574C220.79 311.003 219.227 302.3 218.268 301.296L217.867 302.06L217.712 301.839C217.488 299.929 217.963 295.575 217.883 293.412C217.868 293.036 218.394 291.407 218.363 290.801C218.187 287.255 218.249 283.589 218.774 280.065C219.032 278.345 220.46 274.642 221.105 273.061C225.366 262.613 226.726 250.358 226.265 239.12C226.091 234.835 225.15 230.233 225.031 226.365C224.83 219.955 226.65 218.403 224.553 211.873C223.746 212.553 222.877 213.092 221.998 213.67C227.466 201.759 221.699 203.863 221.782 193.47C221.813 189.781 224.67 185.535 224.752 179.777C223.698 180.754 223.204 181.031 221.991 181.696C223.129 179.588 224.244 177.663 224.849 175.321C225.042 174.574 225.362 173.531 225.93 173.008L226.189 173.138C226.652 174.542 226.236 177.442 226.127 179.021C229.392 172.394 229.647 165.992 229.642 158.841C228.544 160.565 226.707 164.415 226.587 166.419C226.278 171.585 225.874 173.192 221.485 175.986C223.749 172.193 224.683 170.843 224.396 166.394C222.91 167.736 221.469 169.019 219.383 169.115C218.191 169.169 217.269 169.336 216.527 168.239C216.523 168.063 216.518 167.887 216.515 167.711C217.45 166.418 220.115 165.319 221.379 164.333C224.481 161.917 224.81 158.535 227.112 155.49C228.956 153.083 231.356 151.212 233.391 148.976C236.73 145.305 236.051 141.819 241.399 140.431C242.872 138.439 243.438 137.71 245.311 136.164C238.768 134.324 235.667 134.513 229.743 137.773C229.248 138.045 227.487 138.417 226.828 138.607C223.809 139.481 221.553 140.084 219.551 142.698C220.522 144.088 221.427 144.831 222.687 145.93C220.596 145.44 218.357 144.976 216.391 144.116L215.62 142.669C211.741 142.651 209.336 142.53 205.542 141.771C210.412 140.18 214.674 141.057 219.422 140.381L221.162 138.58C217.832 136.945 214.832 136.036 211.39 134.116L212.062 137.589C209.817 134.993 209.743 130.902 209.728 127.569C209.717 125.356 209.743 123.133 209.758 120.919C208.471 122.546 206.471 124.595 204.706 125.68C203.363 126.506 200.411 126.888 199.43 128.146C199.175 129.248 199.989 132.36 200.512 133.393C197.817 137.74 196.085 130.576 194.688 129.868L194.435 130.156C194.4 133.671 196.318 138.975 197.154 142.595L197.225 142.909C192.978 141.083 188.63 142.01 183.437 140.4C183.276 140.061 183.351 140.252 183.218 139.819C181.897 138.872 179.916 137.915 178.442 137.145C181.113 135.736 184.013 134.501 186.785 133.31C186.296 132.904 186.174 130.919 185.777 130.391C185.698 129.349 185.69 127.857 184.381 127.88C183.581 128.33 183.27 128.887 182.952 129.733C183.118 130.512 183.901 132.29 184.485 133.232L184.215 133.453C182.663 133.668 181.11 131.102 180.242 129.699C178.986 127.67 180.772 126.947 181.151 125.403C180.566 124.616 180.144 124.503 179.182 124.613C177.768 124.775 175.88 124.027 175.221 122.624C174.067 120.168 176.88 118.302 177.302 117.082C176.927 116.85 176.679 116.738 176.409 116.379C177.097 115.197 175.539 115.16 176.089 113.554C176.22 113.174 176.27 112.922 176.318 112.519L176.089 112.358C174.046 112.76 174.757 114.446 174.896 115.726L174.688 115.811C174.479 115.7 174.309 115.583 174.144 115.409C173.399 114.622 173.087 113.607 173.132 112.52C173.349 107.226 178.052 108.846 179.18 107.522C179.434 107.223 179.586 106.686 179.5 106.297C179.442 106.034 177.963 105.701 177.623 105.475C177.539 105.419 177.458 105.358 177.375 105.301C177.289 105.244 177.201 105.19 177.115 105.134L176.931 105.011L176.723 105.205C176.608 105.863 176.879 106.533 177.067 107.193L176.945 107.369C175.142 106.408 174.631 103.819 174.9 101.892C175.142 100.155 177.215 98.7104 178.948 99.3073L179.015 99.5008C178.364 99.8361 177.908 100.001 177.429 100.553C177.27 101.162 177.242 100.883 177.451 101.422C178.504 102.358 180.628 102.192 180.942 100.562C181.044 100.035 180.452 99.3466 180.145 98.9195C180.771 98.1944 182.009 96.2882 182.407 95.4174C180.582 95.0401 180.416 96.7884 180.026 97.858C179.062 96.7175 179.09 95.5999 180.203 94.5124C181.723 93.0262 182.594 92.9921 184.555 93.0348L184.621 92.8749C186.134 89.2221 187.083 87.937 190.828 86.3429ZM172.021 237.333C169.877 240.084 168.095 243.404 167.491 246.867C166.435 252.926 167.172 257.277 163.163 262.53C160.098 266.545 156.803 267.033 153.328 270.639C158.328 272.001 154.92 278.464 153.111 278.877C146.132 280.466 145.439 285.15 140.3 290.234C140.376 285.42 141.345 282.976 143.434 278.687C141.728 280.439 139.772 281.907 138.285 283.819C134.85 288.236 135.22 293.377 134.66 298.616C133.964 305.117 129.737 310.333 126.331 315.556C124.191 318.844 122.363 322.589 120.153 325.848C119.568 326.741 117.94 327.643 117.323 328.537C117.391 328.934 117.527 329.375 117.214 329.698C116.161 330.783 114.68 331.418 113.45 332.484C111.647 334.045 109.759 336.947 107.979 338.225C104.496 340.727 103.275 339.577 100.35 343.471C101.528 342.909 102.922 342.091 104.056 341.66L104.272 341.778C103.717 343.599 100.16 345.465 100.228 347.189C101.274 347.263 101.677 346.569 102.345 345.836C103.334 345.023 104.598 343.797 105.836 343.59L106.003 343.766C105.644 345.233 103.838 346.659 102.924 348.002L104.002 349.252C105.869 347.447 107.086 346.034 109.553 345.124C109.394 345.835 109.201 346.799 108.883 347.389C107.844 349.322 103.277 351.152 107.39 352.979C108.708 353.565 113.072 347.039 113.552 346.064C115.014 343.099 116.405 339.938 118.048 337.04C118.721 335.853 119.566 332.642 120.558 332.066C121.269 332.217 121.765 332.614 122.43 332.442C123.98 331.336 123.608 328.578 124.058 326.915C126.097 319.38 131.359 314.553 136.579 309.325C138.54 307.36 140.762 302.834 142.591 300.571C145.323 296.791 147.508 293.88 149.54 289.588C148.507 290.02 147.411 290.499 146.364 290.875C148.078 287.955 149.93 286.24 152.167 283.805C152.786 283.13 154.401 280.529 154.97 280.197C156.72 279.173 158.981 278.18 160.773 277.17C165.143 274.575 170.085 267.646 170.918 262.6C171.404 259.656 170.608 254.12 170.606 250.858C170.603 247.568 172.706 239.891 172.021 237.333ZM228.134 222.898C228.021 224.518 227.475 228.159 227.614 229.597C228.158 235.303 228.707 240.338 228.554 246.106C230.178 249.052 231.252 251.157 232.069 254.533C233.53 260.574 233.2 265.381 236.591 270.853C239.624 275.741 244.694 275.439 244.873 281.668L244.885 282.002C246.272 284.453 247.68 284.788 250.004 286.059C247.942 283.44 247.341 282.219 247.406 278.794C252.994 282.742 257.518 285.566 259.766 292.518C260.564 294.985 261.255 297.601 262.605 299.801C264.816 303.401 268.319 305.747 270.373 309.55C271.637 311.892 272.65 314.265 273.7 316.709L277.899 326.35C278.982 328.893 279.269 329.908 280.82 332.245C281.694 333.562 282.132 337.233 283.586 338.748C285.555 341.854 286.629 345.523 288.919 348.438C289.444 349.105 290.058 351.471 290.864 351.385C291.235 350.881 291.339 350.743 291.868 350.427L292.14 350.467C292.206 351.389 292.213 351.831 292.699 352.628C293.231 352.965 292.952 352.911 293.561 352.811C294.184 352.328 294.199 352.268 294.62 351.573C294.613 351.008 294.562 350.683 294.074 350.27C291.367 347.979 291.485 348.797 290.544 345.124C294.757 347.098 295.083 349.166 297.416 350.534C299.443 348.042 293.092 345.711 293.946 343.72C295.42 343.109 298.164 347.437 299.691 347.354C300.854 346.076 295.858 343.483 295.704 341.94C296.753 340.885 298.658 343.558 300.42 343.471L300.603 343.26C300.396 341.341 296.65 338.434 295.101 337.479C292.239 335.714 289.781 333.481 287.053 331.539C285.943 330.807 283.679 330.324 282.986 329.169C278.936 322.413 275.807 314.432 273.857 306.778C271.855 298.914 270.216 292.499 263.722 287.098C262.495 286.078 261.731 284.813 260.049 284.658C257.694 282.588 257.265 278.871 255.211 276.582C254.145 275.395 252.3 274.956 251.554 273.369C250.389 270.89 250.228 268.016 249.342 265.46C249.325 266.864 249.438 268.738 248.846 269.958L248.622 270.021C246.789 266.415 246.517 265.29 242.953 263.07C239.785 261.099 236.98 257.954 235.733 254.371C233.374 248.467 234.611 242.724 234.103 236.615C233.831 233.358 230.598 224.732 228.134 222.898ZM206.743 288.766C206.597 291.648 206.383 293.864 208.463 296.196C208.699 296.455 208.944 296.71 209.194 296.956L209.394 296.863C208.792 294.482 208.864 293.595 209.257 291.176C207.832 290.479 207.62 289.582 206.743 288.766ZM214.122 212.909C214.175 213.072 214.262 213.329 214.26 213.502C214.214 220.134 210.593 227.748 203.971 229.665C202.876 229.981 202.021 230.018 200.873 230.073C201.102 229.623 202.315 229.047 202.813 228.728C208.751 224.893 211.306 219.272 214.122 212.909ZM179.777 178.816C180.437 180.646 182.746 185.636 183.797 187.21L183.93 187.108L183.96 185.67C184.363 183.683 184.584 183.117 185.569 181.354C182.72 180.889 182.108 180.523 179.777 178.816ZM170.853 157.714C173.231 163.466 172.71 164.606 173.94 170.396C174.028 168.981 174.069 166.503 174.657 165.31L174.874 165.227C175.754 166.111 176.054 166.437 177.092 167.13L177.249 167.059C176.763 166.084 175.769 164.921 175.112 163.977C173.995 162.373 172.358 158.761 170.853 157.714ZM266.182 143.355C261.809 142.465 254.145 140.883 249.711 141.521C244.844 141.966 242.15 142.857 238.996 146.737C238.705 147.097 238.417 147.459 238.132 147.825C243.451 146.217 248.119 144.599 253.729 145.929C252 147.144 250.862 147.975 249.303 149.444C253.763 150.75 255.46 149.478 259.874 148.41C263.974 147.418 267.438 147.727 271.37 149.198C273.831 150.118 274.112 150.733 275.964 151.717C280.493 153.507 281.369 151.189 284.179 148.216C286.565 145.691 289.946 145.171 293.092 144.313C288.65 142.922 283.55 141.959 279.097 143.533C273.763 145.418 271.407 144.419 266.182 143.355ZM155.733 140.812C155.718 140.806 155.703 140.8 155.688 140.794C155.697 140.791 155.706 140.788 155.715 140.785C155.721 140.794 155.727 140.803 155.733 140.812ZM126.223 124.864C127.608 123.687 131.633 124.092 133.332 124.294C141.245 125.233 147.447 128.863 153.968 133.219C162.655 132.204 169.621 131.737 177.304 137.461C172.873 138.312 170.97 138.514 166.908 136.28C163.026 134.146 158.985 135.1 154.914 136.158C156.366 137.386 157.083 138.264 158.136 139.854C157.284 140.249 156.543 140.509 155.715 140.785C154.459 138.953 152.702 136.784 150.884 135.518C148.868 134.186 146.367 133.95 144.268 132.665C139.722 129.882 136.245 125.97 130.691 125.31C129.863 125.211 126.716 125.211 126.223 124.864ZM190.353 124.926C190.291 125.893 189.88 132.524 190.173 133.155C190.538 131.516 190.661 126.531 190.353 124.926ZM194.45 130.035L194.585 129.825C194.576 129.822 194.568 129.818 194.559 129.816L194.45 130.035ZM177.77 120.499C176.033 122.165 176.943 123.126 178.736 123.945C179.586 122.55 179.168 121.287 177.77 120.499ZM191.629 120.701C192.598 121.865 194.577 123.424 195.988 123.779C195.05 122.989 192.745 121.107 191.629 120.701ZM185.981 110.945C186.513 112.295 187.588 114.859 189.126 115.146L189.343 114.94C189.523 113.965 189.137 112.944 188.812 112.03L188.497 112.914C187.214 112.838 186.735 111.901 185.981 110.945ZM213.544 111.279C213.254 111.868 213.134 112.235 212.636 112.656C212.185 112.734 212.082 112.743 211.624 112.744C211.022 113.348 211.046 113.801 210.787 114.724C211.258 114.797 211.699 114.965 212.123 114.641C212.893 114.054 213.58 112.211 213.544 111.279ZM191.373 107.872C191.234 108.806 191.118 109.313 191.73 110.1C192.594 111.211 193.526 112.253 194.508 113.253C194.969 112.974 195.183 112.544 195.491 112.082C195.996 110.136 195.033 110.351 196.421 108.299C194.109 108.768 193.556 108.89 191.373 107.872ZM188.172 110.058C188.088 111.227 188.285 111.77 188.497 112.914L188.812 112.03C188.666 111.434 188.522 110.458 188.172 110.058ZM214.945 99.6352C214.072 99.9466 213.369 99.9487 212.461 100C213.361 100.678 214.444 100.9 215.088 101.622L214.911 101.889C214.204 101.965 213.619 101.469 212.803 101.216C212.294 102.801 214.895 103.207 215.909 103.339L215.172 105.573C215.737 106.126 216.674 107.228 217.331 107.329C217.483 106.798 217.428 106.865 217.379 106.281C219.826 107.042 220.57 107.212 223.069 107.531C220.794 106.092 219.641 106.73 217.483 104.981C217.733 103.208 217.522 103.182 218.732 102.026C218.28 101.485 217.555 101.726 217.076 101.526C216.642 101.344 215.376 99.7033 214.945 99.6352ZM336.165 85.9538C337.106 85.9129 337.14 85.8943 337.696 86.683C337.901 88.7504 333.244 90.0972 331.638 90.719C330.314 93.2347 328.349 93.0007 325.935 92.6494C324.781 93.247 322.891 94.1857 321.988 95.0897C319.915 97.1633 319.198 98.4367 316.718 100.153L315.299 100.9C317.695 97.0164 320.231 92.2735 325.217 92.2355C329.019 88.2802 331.251 88.2965 336.165 85.9538ZM62.989 85.9157C64.3419 85.9221 71.3604 89.077 72.5164 89.975C75.0493 91.9426 73.0882 91.9707 76.7373 92.2344C79.2203 92.4141 83.3857 97.9586 84.5192 100.373L84.3086 100.54C81.4714 99.1774 80.4018 97.2009 78.2046 95.1289C77.0751 94.0635 75.3625 93.1695 73.99 92.4072C71.6544 93.3812 69.5052 92.9464 68.2197 90.6244C66.3541 89.7293 61.1363 88.6532 62.989 85.9157Z" fill="#030303"></path><defs><linearGradient id="paint0_linear_6337_1342" x1="200" y1="0" x2="200" y2="400" gradientUnits="userSpaceOnUse"><stop stop-color="#56FF40"></stop><stop offset="1" stop-color="#39DE24"></stop></linearGradient></defs></g></svg>
\ No newline at end of file
diff --git a/plugins/harness/mcp.json b/plugins/harness/mcp.json
new file mode 100644
index 000000000..f5d058f5c
--- /dev/null
+++ b/plugins/harness/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "harness": {
+ "command": "harness",
+ "args": ["mcp"]
+ }
+ }
+}
diff --git a/server.json b/server.json
new file mode 100644
index 000000000..05c9a5a6e
--- /dev/null
+++ b/server.json
@@ -0,0 +1,30 @@
+{
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+ "name": "io.github.autonomous-ai/harness",
+ "title": "Harness",
+ "description": "Start Claude Code and Codex agents the person can watch, wait for them and read their answers.",
+ "websiteUrl": "https://harness.autonomous.ai/agents",
+ "repository": {
+ "url": "https://github.com/autonomous-ai/openharness",
+ "source": "github"
+ },
+ "version": "0.0.0",
+ "packages": [
+ {
+ "registryType": "npm",
+ "identifier": "@autonomous-ai/harness-mcp",
+ "version": "0.1.0",
+ "transport": {
+ "type": "stdio"
+ }
+ },
+ {
+ "registryType": "mcpb",
+ "identifier": "https://github.com/autonomous-ai/openharness/releases/download/v0.0.0_cli/harness-mcp.mcpb",
+ "fileSha256": "0000000000000000000000000000000000000000000000000000000000000000",
+ "transport": {
+ "type": "stdio"
+ }
+ }
+ ]
+}
diff --git a/website/package-lock.json b/website/package-lock.json
index 896faabca..01d37e48a 100644
--- a/website/package-lock.json
+++ b/website/package-lock.json
@@ -20,6 +20,7 @@
"@types/react": "^19",
"@types/react-dom": "^19",
"@vitejs/plugin-react": "^5.1.2",
+ "ajv": "^6.15.0",
"eslint": "^9",
"eslint-config-next": "16.1.1",
"jsdom": "^27.4.0",
diff --git a/website/package.json b/website/package.json
index c9be0b918..c4cf0942b 100644
--- a/website/package.json
+++ b/website/package.json
@@ -31,6 +31,7 @@
"@types/react": "^19",
"@types/react-dom": "^19",
"@vitejs/plugin-react": "^5.1.2",
+ "ajv": "^6.15.0",
"eslint": "^9",
"eslint-config-next": "16.1.1",
"jsdom": "^27.4.0",
diff --git a/website/public/agents/index.html b/website/public/agents/index.html
index 77617ee7a..076ef9206 100644
--- a/website/public/agents/index.html
+++ b/website/public/agents/index.html
@@ -232,6 +232,23 @@ harness new codex @mini ~/code/app --name train -- "Run the training script and
</tbody>
</table>
</div>
+ <h3 id="mcp-clients">Add it to a client</h3>
+ <pre><code>{"mcpServers": {"harness": {"command": "harness", "args": ["mcp"]}}}</code></pre>
+ <p>Or in one step, once Harness is installed:
+ <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=harness&amp;config=eyJjb21tYW5kIjoiaGFybmVzcyIsImFyZ3MiOlsibWNwIl19">Add to Cursor</a>,
+ <a href="vscode:mcp/install?%7B%22name%22%3A%22harness%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22harness%22%2C%22args%22%3A%5B%22mcp%22%5D%7D">Add to VS Code</a>
+ (<a href="vscode-insiders:mcp/install?%7B%22name%22%3A%22harness%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22harness%22%2C%22args%22%3A%5B%22mcp%22%5D%7D">Insiders</a>),
+ <a href="lmstudio://add_mcp?name=harness&amp;config=eyJjb21tYW5kIjoiaGFybmVzcyIsImFyZ3MiOlsibWNwIl19">Add to LM Studio</a>,
+ or in Claude Code <code>claude mcp add harness -- harness mcp</code>. An app opened from the Finder may not have
+ <code>~/.local/bin</code> on its PATH; if it cannot find <code>harness</code>, give it the full path that
+ <code>command -v harness</code> prints.</p>
+ <p>Through npm, for clients that start servers with <code>npx</code>: <code>@autonomous-ai/harness-mcp</code> runs
+ <code>harness mcp</code> from the installed CLI, and where Harness is not installed it offers one tool,
+ <code>harness_setup</code>, that says how to install it.
+ <a href="goose://extension?cmd=npx&amp;arg=-y&amp;arg=%40autonomous-ai%2Fharness-mcp&amp;timeout=660&amp;id=harness&amp;name=Harness&amp;description=Start%20Claude%20Code%20and%20Codex%20agents%20the%20person%20can%20watch%2C%20wait%20for%20them%20and%20read%20their%20answers.">Add to goose</a>
+ uses this form.</p>
+ <pre><code>{"mcpServers": {"harness": {"command": "npx", "args": ["-y", "@autonomous-ai/harness-mcp"]}}}
+claude mcp add harness -- npx -y @autonomous-ai/harness-mcp</code></pre>
<h2 id="rules">Rules</h2>
<ul>
diff --git a/website/public/llms.txt b/website/public/llms.txt
index f90965f69..25d618d14 100644
--- a/website/public/llms.txt
+++ b/website/public/llms.txt
@@ -20,7 +20,7 @@ harness send NAME "text" # a follow-up to one you sta
harness close NAME [--now] # save its screen and stop it; the conversation is kept
```
-`harness mcp` serves the same as MCP tools over stdio (command `harness`, arguments `["mcp"]`): `harness_list`, `harness_start`, `harness_wait`, `harness_read`, `harness_close`, and `harness_send` inside a harness.
+`harness mcp` serves the same as MCP tools over stdio (command `harness`, arguments `["mcp"]`): `harness_list`, `harness_start`, `harness_wait`, `harness_read`, `harness_close`, and `harness_send` inside a harness. For clients that start servers with npx, `npx -y @autonomous-ai/harness-mcp` runs `harness mcp`, or, where Harness is not installed, offers one tool, `harness_setup`, that says how to install it.
Start a harness for work that can run beside yours, needs another agent's view (a review, a second opinion from Codex), takes long, or belongs in its own folder; do small, quick work yourself. List first, name every harness, then wait, read and close it. Give work only to harnesses you started, and close only those; never answer a harness's question or permission prompt, and never ask one to publish, deploy, delete or push. An agent outside Harness (Claude Code or Codex in a terminal app or editor) is recognized by its session: it gets the same limits, may close only what its session started, and cannot be messaged.
diff --git a/website/scripts/agents-site.spec.ts b/website/scripts/agents-site.spec.ts
index 3cad72f64..5c5e9882b 100644
--- a/website/scripts/agents-site.spec.ts
+++ b/website/scripts/agents-site.spec.ts
@@ -111,6 +111,44 @@ describe("the pages and skill agents read", () => {
}
});
+ it("installs the MCP server from each editor's link as the plugin registers it", () => {
+ // The formats, as each editor documents them on 2026-10-11: Cursor (cursor.com/docs/mcp/install-links) and
+ // LM Studio (lmstudio.ai/docs/app/mcp/deeplink) take a name and the base64 of the server's config; VS Code
+ // (code.visualstudio.com/docs/copilot/guides/mcp-developer-guide) the URL-encoded config with its name in it,
+ // and its mcp.json reference marks `type` required; goose (its docs, getting-started/using-extensions) only
+ // commands such as npx, an `arg` per argument.
+ const server = (JSON.parse(readFileSync(join(repo, "plugins", "harness", ".mcp.json"), "utf8")) as { mcpServers: Record<string, unknown> }).mcpServers.harness;
+ const links = [...page.matchAll(/href="((?:cursor|vscode|vscode-insiders|lmstudio|goose):[^"]+)"/g)].map((m) => decode(m[1]));
+ const base64 = (value: string | null) => JSON.parse(Buffer.from(value ?? "", "base64").toString("utf8"));
+ const query = (link: string) => new URL(link).searchParams;
+
+ const cursor = links.filter((link) => link.startsWith("cursor://anysphere.cursor-deeplink/mcp/install?"));
+ const vscode = links.filter((link) => /^vscode(-insiders)?:mcp\/install\?/.test(link));
+ const lmstudio = links.filter((link) => link.startsWith("lmstudio://add_mcp?"));
+ const goose = links.filter((link) => link.startsWith("goose://extension?"));
+ expect([cursor.length, vscode.length, lmstudio.length, goose.length]).toEqual([1, 2, 1, 1]);
+ expect(links).toHaveLength(5);
+
+ expect(query(cursor[0]).get("name")).toBe("harness");
+ expect(base64(query(cursor[0]).get("config"))).toEqual(server);
+ for (const link of vscode) expect(JSON.parse(decodeURIComponent(link.slice(link.indexOf("?") + 1)))).toEqual({ name: "harness", type: "stdio", ...(server as object) });
+ expect(query(lmstudio[0]).get("name")).toBe("harness");
+ expect(base64(query(lmstudio[0]).get("config"))).toEqual(server);
+
+ // goose runs the npm package, as the npx form beside it does, which server.json lists for the MCP Registry.
+ const npm = (JSON.parse(readFileSync(join(repo, "server.json"), "utf8")) as { packages: { registryType: string; identifier: string }[] })
+ .packages.find((pkg) => pkg.registryType === "npm")!.identifier;
+ const g = query(goose[0]);
+ expect([g.get("cmd"), ...g.getAll("arg")]).toEqual(["npx", "-y", npm]);
+ expect(g.get("id")).toBe("harness");
+ expect(page).toContain(`{"command": "npx", "args": ["-y", "${npm}"]}`);
+ expect(page).toContain(`claude mcp add harness -- npx -y ${npm}`);
+ expect(llms).toContain(`npx -y ${npm}`);
+ // goose ends a call after `timeout` seconds; harness_wait may wait up to its maximum.
+ const waitMax = Number(readFileSync(join(repo, "cli", "src", "agentClient", "mcp.ts"), "utf8").match(/const WAIT_MAX_S = (\d+)/)![1]);
+ expect(Number(g.get("timeout"))).toBeGreaterThan(waitMax);
+ });
+
it("links the skill where it is in this repository", () => {
for (const text of [page, llms]) {
for (const m of text.matchAll(/https:\/\/(?:raw\.githubusercontent\.com\/autonomous-ai\/openharness\/main|github\.com\/autonomous-ai\/openharness\/(?:blob|tree)\/main)\/([^\s")]+)/g)) {
diff --git a/website/scripts/listings.spec.ts b/website/scripts/listings.spec.ts
new file mode 100644
index 000000000..cb066f1ca
--- /dev/null
+++ b/website/scripts/listings.spec.ts
@@ -0,0 +1,126 @@
+// @vitest-environment node
+import Ajv from "ajv";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { describe, expect, it } from "vitest";
+import { ASSET, MCPB, releasedServerJson } from "../../cli/packages/harness-mcp/mcpb/build.mjs";
+
+// The files directories read to list Harness (docs/research/2026-10-11-listing-submissions.md): server.json for the
+// Official MCP Registry, the MCP Bundle's manifest, the Cursor plugin and glama.json. A directory rejects a bad one
+// only when it is submitted, after a release; these checks reject it here.
+//
+// The schemas are vendored as published on 2026-10-11: the registry's from
+// https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json, the bundle's from
+// github.com/modelcontextprotocol/mcpb schemas/mcpb-manifest-v0.3.schema.json (the version `mcpb pack` 2.1.2 checks).
+const repo = join(process.cwd(), "..");
+const read = (...path: string[]) => readFileSync(join(repo, ...path), "utf8");
+const json = (...path: string[]) => JSON.parse(read(...path));
+const schemas = join(process.cwd(), "scripts", "schemas");
+const ajv = new Ajv({ allErrors: true });
+const registrySchema = JSON.parse(readFileSync(join(schemas, "mcp-registry-server-2025-12-11.schema.json"), "utf8"));
+const validServer = ajv.compile(registrySchema);
+const validManifest = ajv.compile(JSON.parse(readFileSync(join(schemas, "mcpb-manifest-0.3.schema.json"), "utf8")));
+
+interface Pkg { registryType: string; identifier: string; version?: string; fileSha256?: string; registryBaseUrl?: string; transport: { type: string } }
+interface Server { $schema: string; name: string; description: string; version: string; packages: Pkg[] }
+
+const server = json("server.json") as Server;
+const manifest = json("cli", "packages", "harness-mcp", "mcpb", "manifest.json");
+
+/** What the registry checks beyond the schema when it publishes (its internal/validators, read on 2026-10-11). */
+function registryRules(entry: Server) {
+ expect(entry.name).toBe("io.github.autonomous-ai/harness");
+ expect(entry.packages.map((pkg) => pkg.registryType).sort()).toEqual(["mcpb", "npm"]);
+ for (const pkg of entry.packages) expect(pkg.transport).toEqual({ type: "stdio" });
+ const npm = entry.packages.find((pkg) => pkg.registryType === "npm")!;
+ expect(npm.version).toMatch(/^\d+\.\d+\.\d+$/);
+ expect(npm.fileSha256).toBeUndefined();
+ expect([undefined, "https://registry.npmjs.org"]).toContain(npm.registryBaseUrl);
+ const mcpb = entry.packages.find((pkg) => pkg.registryType === "mcpb")!;
+ expect(mcpb.registryBaseUrl).toBeUndefined();
+ expect(mcpb.fileSha256).toMatch(/^[a-f0-9]{64}$/);
+ // A GitHub release asset, and the URL must say "mcp".
+ expect(mcpb.identifier).toMatch(/^https:\/\/github\.com\/autonomous-ai\/openharness\/releases\/download\/[^/]+\/[^/]+$/);
+ expect(mcpb.identifier.toLowerCase()).toContain("mcp");
+}
+
+describe("the files directories list Harness from", () => {
+ it("server.json follows the registry's schema and rules, with placeholders the build fills", () => {
+ expect(server.$schema).toBe(registrySchema.$id);
+ expect(validServer(server), ajv.errorsText(validServer.errors)).toBe(true);
+ registryRules(server);
+ expect(server.version).toBe("0.0.0");
+ expect(server.packages.find((pkg) => pkg.registryType === "mcpb")!.fileSha256).toBe("0".repeat(64));
+ });
+
+ it("the server.json a release publishes points at that release's bundle", () => {
+ const sha256 = "ab".repeat(32);
+ const released = releasedServerJson(server, { version: "0.3.74", tag: "v0.3.74_cli", sha256, npmVersion: "0.1.0" }) as Server;
+ expect(validServer(released), ajv.errorsText(validServer.errors)).toBe(true);
+ registryRules(released);
+ expect(released.version).toBe("0.3.74");
+ expect(released.packages.find((pkg) => pkg.registryType === "mcpb")).toMatchObject({
+ identifier: `https://github.com/autonomous-ai/openharness/releases/download/v0.3.74_cli/${ASSET}`,
+ fileSha256: sha256,
+ });
+ expect(server.version).toBe("0.0.0");
+ });
+
+ it("names the npm package that names this server", () => {
+ const npm = server.packages.find((pkg) => pkg.registryType === "npm")!;
+ expect(npm.identifier).toBe("@autonomous-ai/harness-mcp");
+ const packageJson = join(repo, "cli", "packages", "harness-mcp", "package.json");
+ // The registry accepts the npm entry only when the package's `mcpName` is this server's name.
+ if (existsSync(packageJson)) {
+ const pkg = JSON.parse(readFileSync(packageJson, "utf8"));
+ expect(pkg.name).toBe(npm.identifier);
+ expect(pkg.mcpName).toBe(server.name);
+ }
+ });
+
+ it("the bundle's manifest follows the MCPB schema and lists the tools harness mcp serves", () => {
+ expect(validManifest(manifest), ajv.errorsText(validManifest.errors)).toBe(true);
+ expect(MCPB).toMatch(/^@anthropic-ai\/mcpb@\d+\.\d+\.\d+$/);
+ expect(manifest.manifest_version).toBe("0.3");
+ expect(manifest.version).toBe("0.0.0");
+ // build.mjs puts the npm package's bin.mjs at server/bin.mjs; Claude Desktop runs it on its own Node.
+ expect(manifest.server).toEqual({ type: "node", entry_point: "server/bin.mjs", mcp_config: { command: "node", args: ["${__dirname}/server/bin.mjs"] } });
+ expect(manifest.description).toBe(server.description);
+ expect(manifest.long_description).toContain("curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash");
+ // harness_send is offered only inside a harness's pane, which an app's server never runs in.
+ const served = [...read("cli", "src", "agentClient", "mcp.ts").matchAll(/^\s+name: '(harness_[a-z]+)',$/gm)].map((m) => m[1]);
+ expect(served).toContain("harness_send");
+ expect(manifest.tools.map((tool: { name: string }) => tool.name)).toEqual(served.filter((name) => name !== "harness_send"));
+ });
+
+ it("the Cursor plugin is the same plugin, with the same MCP server", () => {
+ const marketplace = json(".cursor-plugin", "marketplace.json");
+ const claudeMarketplace = json(".claude-plugin", "marketplace.json");
+ expect(marketplace.name).toBe(claudeMarketplace.name);
+ expect(marketplace.owner.name).toBeTruthy();
+ expect(marketplace.plugins).toHaveLength(1);
+ const [entry] = marketplace.plugins;
+ expect(entry.source).not.toMatch(/^\.|\.\./);
+ expect(join(repo, entry.source)).toBe(join(repo, claudeMarketplace.plugins[0].source));
+ const plugin = json(entry.source, ".cursor-plugin", "plugin.json");
+ expect(plugin.name).toBe(entry.name);
+ expect(plugin.name).toMatch(/^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/);
+ expect(plugin.name).toBe(json(entry.source, ".claude-plugin", "plugin.json").name);
+ // Cursor resolves a relative logo inside the repository and refuses `..` and absolute paths.
+ expect(plugin.logo).not.toMatch(/^\/|\.\./);
+ expect(existsSync(join(repo, entry.source, plugin.logo))).toBe(true);
+ // Cursor reads mcp.json, Claude Code and Codex .mcp.json: one server, written twice.
+ expect(json(entry.source, "mcp.json")).toEqual(json(entry.source, ".mcp.json"));
+ expect(existsSync(join(repo, entry.source, "skills", "harness", "SKILL.md"))).toBe(true);
+ });
+
+ it("glama.json names maintainers, and the image Glama builds runs harness mcp from the installer", () => {
+ const glama = json("glama.json");
+ expect(glama.$schema).toBe("https://glama.ai/mcp/schemas/server.json");
+ expect(glama.maintainers.length).toBeGreaterThan(0);
+ expect(new Set(glama.maintainers).size).toBe(glama.maintainers.length);
+ const dockerfile = read("cli", "docker", "harness-mcp", "Dockerfile");
+ expect(dockerfile).toContain("RUN curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash");
+ expect(dockerfile).toMatch(/^CMD \["harness", "mcp"\]$/m);
+ });
+});
diff --git a/website/scripts/schemas/mcp-registry-server-2025-12-11.schema.json b/website/scripts/schemas/mcp-registry-server-2025-12-11.schema.json
new file mode 100644
index 000000000..9f6469b79
--- /dev/null
+++ b/website/scripts/schemas/mcp-registry-server-2025-12-11.schema.json
@@ -0,0 +1,574 @@
+{
+ "$comment": "This file is auto-generated from docs/reference/api/openapi.yaml. Do not edit manually. Run 'make generate-schema' to update.",
+ "$id": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+ "$ref": "#/definitions/ServerDetail",
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Argument": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PositionalArgument"
+ },
+ {
+ "$ref": "#/definitions/NamedArgument"
+ }
+ ],
+ "description": "Warning: Arguments construct command-line parameters that may contain user-provided input. This creates potential command injection risks if clients execute commands in a shell environment. For example, a malicious argument value like ';rm -rf ~/Development' could execute dangerous commands. Clients should prefer non-shell execution methods (e.g., posix_spawn) when possible to eliminate injection risks entirely. Where not possible, clients should obtain consent from users or agents to run the resolved command before execution."
+ },
+ "Icon": {
+ "description": "An optionally-sized icon that can be displayed in a user interface.",
+ "properties": {
+ "mimeType": {
+ "description": "Optional MIME type override if the source MIME type is missing or generic. Must be one of: image/png, image/jpeg, image/jpg, image/svg+xml, image/webp.",
+ "enum": [
+ "image/png",
+ "image/jpeg",
+ "image/jpg",
+ "image/svg+xml",
+ "image/webp"
+ ],
+ "example": "image/png",
+ "type": "string"
+ },
+ "sizes": {
+ "description": "Optional array of strings that specify sizes at which the icon can be used. Each string should be in WxH format (e.g., '48x48', '96x96') or 'any' for scalable formats like SVG. If not provided, the client should assume that the icon can be used at any size.",
+ "examples": [
+ [
+ "48x48",
+ "96x96"
+ ],
+ [
+ "any"
+ ]
+ ],
+ "items": {
+ "pattern": "^(\\d+x\\d+|any)$",
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "src": {
+ "description": "A standard URI pointing to an icon resource. Must be an HTTPS URL. Consumers SHOULD take steps to ensure URLs serving icons are from the same domain as the server or a trusted domain. Consumers SHOULD take appropriate precautions when consuming SVGs as they can contain executable JavaScript.",
+ "example": "https://example.com/icon.png",
+ "format": "uri",
+ "maxLength": 255,
+ "type": "string"
+ },
+ "theme": {
+ "description": "Optional specifier for the theme this icon is designed for. 'light' indicates the icon is designed to be used with a light background, and 'dark' indicates the icon is designed to be used with a dark background. If not provided, the client should assume the icon can be used with any theme.",
+ "enum": [
+ "light",
+ "dark"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "Input": {
+ "properties": {
+ "choices": {
+ "description": "A list of possible values for the input. If provided, the user must select one of these values.",
+ "example": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "default": {
+ "description": "The default value for the input. This should be a valid value for the input. If you want to provide input examples or guidance, use the `placeholder` field instead.",
+ "type": "string"
+ },
+ "description": {
+ "description": "A description of the input, which clients can use to provide context to the user.",
+ "type": "string"
+ },
+ "format": {
+ "default": "string",
+ "description": "Specifies the input format. Supported values include `filepath`, which should be interpreted as a file on the user's filesystem.\n\nWhen the input is converted to a string, booleans should be represented by the strings \"true\" and \"false\", and numbers should be represented as decimal values.",
+ "enum": [
+ "string",
+ "number",
+ "boolean",
+ "filepath"
+ ],
+ "type": "string"
+ },
+ "isRequired": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "description": "Indicates whether the input is a secret value (e.g., password, token). If true, clients should handle the value securely.",
+ "type": "boolean"
+ },
+ "placeholder": {
+ "description": "A placeholder for the input to be displaying during configuration. This is used to provide examples or guidance about the expected form or content of the input.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The value for the input. If this is not set, the user may be prompted to provide a value. If a value is set, it should not be configurable by end users.\n\nIdentifiers wrapped in `{curly_braces}` will be replaced with the corresponding properties from the input `variables` map. If an identifier in braces is not found in `variables`, or if `variables` is not provided, the `{curly_braces}` substring should remain unchanged.\n",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "InputWithVariables": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Input"
+ },
+ {
+ "properties": {
+ "variables": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Input"
+ },
+ "description": "A map of variable names to their values. Keys in the input `value` that are wrapped in `{curly_braces}` will be replaced with the corresponding variable values.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "KeyValueInput": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/InputWithVariables"
+ },
+ {
+ "properties": {
+ "name": {
+ "description": "Name of the header or environment variable.",
+ "example": "SOME_VARIABLE",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "LocalTransport": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/StdioTransport"
+ },
+ {
+ "$ref": "#/definitions/StreamableHttpTransport"
+ },
+ {
+ "$ref": "#/definitions/SseTransport"
+ }
+ ],
+ "description": "Transport protocol configuration for local/package context"
+ },
+ "NamedArgument": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/InputWithVariables"
+ },
+ {
+ "properties": {
+ "isRepeated": {
+ "default": false,
+ "description": "Whether the argument can be repeated multiple times.",
+ "type": "boolean"
+ },
+ "name": {
+ "description": "The flag name, including any leading dashes.",
+ "example": "--port",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "named"
+ ],
+ "example": "named",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "name"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "A command-line `--flag={value}`."
+ },
+ "Package": {
+ "properties": {
+ "environmentVariables": {
+ "description": "A mapping of environment variables to be set when running the package.",
+ "items": {
+ "$ref": "#/definitions/KeyValueInput"
+ },
+ "type": "array"
+ },
+ "fileSha256": {
+ "description": "SHA-256 hash of the package file for integrity verification. Required for MCPB packages and optional for other package types. Authors are responsible for generating correct SHA-256 hashes when creating server.json. If present, MCP clients must validate the downloaded file matches the hash before running packages to ensure file integrity.",
+ "example": "fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce",
+ "pattern": "^[a-f0-9]{64}$",
+ "type": "string"
+ },
+ "identifier": {
+ "description": "Package identifier - either a package name (for registries) or URL (for direct downloads)",
+ "examples": [
+ "@modelcontextprotocol/server-brave-search",
+ "https://github.com/example/releases/download/v1.0.0/package.mcpb"
+ ],
+ "type": "string"
+ },
+ "packageArguments": {
+ "description": "A list of arguments to be passed to the package's binary.",
+ "items": {
+ "$ref": "#/definitions/Argument"
+ },
+ "type": "array"
+ },
+ "registryBaseUrl": {
+ "description": "Base URL of the package registry",
+ "examples": [
+ "https://registry.npmjs.org",
+ "https://pypi.org",
+ "https://docker.io",
+ "https://api.nuget.org/v3/index.json",
+ "https://github.com",
+ "https://gitlab.com"
+ ],
+ "format": "uri",
+ "type": "string"
+ },
+ "registryType": {
+ "description": "Registry type indicating how to download packages (e.g., 'npm', 'pypi', 'oci', 'nuget', 'mcpb')",
+ "examples": [
+ "npm",
+ "pypi",
+ "oci",
+ "nuget",
+ "mcpb"
+ ],
+ "type": "string"
+ },
+ "runtimeArguments": {
+ "description": "A list of arguments to be passed to the package's runtime command (such as docker or npx). The `runtimeHint` field should be provided when `runtimeArguments` are present.",
+ "items": {
+ "$ref": "#/definitions/Argument"
+ },
+ "type": "array"
+ },
+ "runtimeHint": {
+ "description": "A hint to help clients determine the appropriate runtime for the package. This field should be provided when `runtimeArguments` are present.",
+ "examples": [
+ "npx",
+ "uvx",
+ "docker",
+ "dnx"
+ ],
+ "type": "string"
+ },
+ "transport": {
+ "$ref": "#/definitions/LocalTransport",
+ "description": "Transport protocol configuration for the package"
+ },
+ "version": {
+ "description": "Package version. Must be a specific version. Version ranges are rejected (e.g., '^1.2.3', '~1.2.3', '\u003e=1.2.3', '1.x', '1.*').",
+ "example": "1.0.2",
+ "minLength": 1,
+ "not": {
+ "const": "latest"
+ },
+ "type": "string"
+ }
+ },
+ "required": [
+ "registryType",
+ "identifier",
+ "transport"
+ ],
+ "type": "object"
+ },
+ "PositionalArgument": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/InputWithVariables"
+ },
+ {
+ "anyOf": [
+ {
+ "required": [
+ "valueHint"
+ ]
+ },
+ {
+ "required": [
+ "value"
+ ]
+ }
+ ],
+ "properties": {
+ "isRepeated": {
+ "default": false,
+ "description": "Whether the argument can be repeated multiple times in the command line.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "positional"
+ ],
+ "example": "positional",
+ "type": "string"
+ },
+ "valueHint": {
+ "description": "An identifier for the positional argument. It is not part of the command line. It may be used by client configuration as a label identifying the argument. It is also used to identify the value in transport URL variable substitution.",
+ "example": "file_path",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "A positional input is a value inserted verbatim into the command line."
+ },
+ "RemoteTransport": {
+ "allOf": [
+ {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/StreamableHttpTransport"
+ },
+ {
+ "$ref": "#/definitions/SseTransport"
+ }
+ ]
+ },
+ {
+ "properties": {
+ "variables": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Input"
+ },
+ "description": "Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ ],
+ "description": "Transport protocol configuration for remote context - extends StreamableHttpTransport or SseTransport with variables"
+ },
+ "Repository": {
+ "description": "Repository metadata for the MCP server source code. Enables users and security experts to inspect the code, improving transparency.",
+ "properties": {
+ "id": {
+ "description": "Repository identifier from the hosting service (e.g., GitHub repo ID). Owned and determined by the source forge. Should remain stable across repository renames and may be used to detect repository resurrection attacks - if a repository is deleted and recreated, the ID should change. For GitHub, use: gh api repos/\u003cowner\u003e/\u003crepo\u003e --jq '.id'",
+ "example": "b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9",
+ "type": "string"
+ },
+ "source": {
+ "description": "Repository hosting service identifier. Used by registries to determine validation and API access methods.",
+ "example": "github",
+ "type": "string"
+ },
+ "subfolder": {
+ "description": "Optional relative path from repository root to the server location within a monorepo or nested package structure. Must be a clean relative path.",
+ "example": "src/everything",
+ "type": "string"
+ },
+ "url": {
+ "description": "Repository URL for browsing source code. Should support both web browsing and git clone operations.",
+ "example": "https://github.com/modelcontextprotocol/servers",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "url",
+ "source"
+ ],
+ "type": "object"
+ },
+ "ServerDetail": {
+ "description": "Schema for a static representation of an MCP server. Used in various contexts related to discovery, installation, and configuration.",
+ "properties": {
+ "$schema": {
+ "description": "JSON Schema URI for this server.json format",
+ "example": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+ "format": "uri",
+ "type": "string"
+ },
+ "_meta": {
+ "description": "Extension metadata using reverse DNS namespacing for vendor-specific data",
+ "properties": {
+ "io.modelcontextprotocol.registry/publisher-provided": {
+ "additionalProperties": true,
+ "description": "Publisher-provided metadata for downstream registries",
+ "example": {
+ "buildInfo": {
+ "commit": "abc123def456",
+ "pipelineId": "build-789",
+ "timestamp": "2023-12-01T10:30:00Z"
+ },
+ "tool": "publisher-cli",
+ "version": "1.2.3"
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ },
+ "description": {
+ "description": "Clear human-readable explanation of server functionality. Should focus on capabilities, not implementation details.",
+ "example": "MCP server providing weather data and forecasts via OpenWeatherMap API",
+ "maxLength": 100,
+ "minLength": 1,
+ "type": "string"
+ },
+ "icons": {
+ "description": "Optional set of sized icons that the client can display in a user interface. Clients that support rendering icons MUST support at least the following MIME types: image/png and image/jpeg (safe, universal compatibility). Clients SHOULD also support: image/svg+xml (scalable but requires security precautions) and image/webp (modern, efficient format).",
+ "items": {
+ "$ref": "#/definitions/Icon"
+ },
+ "type": "array"
+ },
+ "name": {
+ "description": "Server name in reverse-DNS format. Must contain exactly one forward slash separating namespace from server name.",
+ "example": "io.github.user/weather",
+ "maxLength": 200,
+ "minLength": 3,
+ "pattern": "^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$",
+ "type": "string"
+ },
+ "packages": {
+ "items": {
+ "$ref": "#/definitions/Package"
+ },
+ "type": "array"
+ },
+ "remotes": {
+ "items": {
+ "$ref": "#/definitions/RemoteTransport"
+ },
+ "type": "array"
+ },
+ "repository": {
+ "$ref": "#/definitions/Repository",
+ "description": "Optional repository metadata for the MCP server source code. Recommended for transparency and security inspection."
+ },
+ "title": {
+ "description": "Optional human-readable title or display name for the MCP server. MCP subregistries or clients MAY choose to use this for display purposes.",
+ "example": "Weather API",
+ "maxLength": 100,
+ "minLength": 1,
+ "type": "string"
+ },
+ "version": {
+ "description": "Version string for this server. SHOULD follow semantic versioning (e.g., '1.0.2', '2.1.0-alpha'). Equivalent of Implementation.version in MCP specification. Non-semantic versions are allowed but may not sort predictably. Version ranges are rejected (e.g., '^1.2.3', '~1.2.3', '\u003e=1.2.3', '1.x', '1.*').",
+ "example": "1.0.2",
+ "maxLength": 255,
+ "type": "string"
+ },
+ "websiteUrl": {
+ "description": "Optional URL to the server's homepage, documentation, or project website. This provides a central link for users to learn more about the server. Particularly useful when the server has custom installation instructions or setup requirements.",
+ "example": "https://modelcontextprotocol.io/examples",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "description",
+ "version"
+ ],
+ "type": "object"
+ },
+ "SseTransport": {
+ "properties": {
+ "headers": {
+ "description": "HTTP headers to include",
+ "items": {
+ "$ref": "#/definitions/KeyValueInput"
+ },
+ "type": "array"
+ },
+ "type": {
+ "description": "Transport type",
+ "enum": [
+ "sse"
+ ],
+ "example": "sse",
+ "type": "string"
+ },
+ "url": {
+ "description": "Server-Sent Events endpoint URL template. Variables in {curly_braces} are resolved based on context: In Package context, they reference argument valueHints, argument names, or environment variable names from the parent Package. In Remote context, they reference variables from the transport's 'variables' object. After variable substitution, this should produce a valid URI.",
+ "example": "https://mcp-fs.example.com/sse",
+ "pattern": "^https?://[^\\s]+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ "StdioTransport": {
+ "properties": {
+ "type": {
+ "description": "Transport type",
+ "enum": [
+ "stdio"
+ ],
+ "example": "stdio",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ "StreamableHttpTransport": {
+ "properties": {
+ "headers": {
+ "description": "HTTP headers to include",
+ "items": {
+ "$ref": "#/definitions/KeyValueInput"
+ },
+ "type": "array"
+ },
+ "type": {
+ "description": "Transport type",
+ "enum": [
+ "streamable-http"
+ ],
+ "example": "streamable-http",
+ "type": "string"
+ },
+ "url": {
+ "description": "URL template for the streamable-http transport. Variables in {curly_braces} are resolved based on context: In Package context, they reference argument valueHints, argument names, or environment variable names from the parent Package. In Remote context, they reference variables from the transport's 'variables' object. After variable substitution, this should produce a valid URI.",
+ "example": "https://api.example.com/mcp",
+ "pattern": "^https?://[^\\s]+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ }
+ },
+ "title": "server.json defining a Model Context Protocol (MCP) server"
+}
diff --git a/website/scripts/schemas/mcpb-manifest-0.3.schema.json b/website/scripts/schemas/mcpb-manifest-0.3.schema.json
new file mode 100644
index 000000000..64471c546
--- /dev/null
+++ b/website/scripts/schemas/mcpb-manifest-0.3.schema.json
@@ -0,0 +1,376 @@
+{
+ "type": "object",
+ "properties": {
+ "$schema": {
+ "type": "string"
+ },
+ "dxt_version": {
+ "type": "string",
+ "const": "0.3",
+ "description": "@deprecated Use manifest_version instead"
+ },
+ "manifest_version": {
+ "type": "string",
+ "const": "0.3"
+ },
+ "name": {
+ "type": "string"
+ },
+ "display_name": {
+ "type": "string"
+ },
+ "version": {
+ "type": "string"
+ },
+ "description": {
+ "type": "string"
+ },
+ "long_description": {
+ "type": "string"
+ },
+ "author": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "email": {
+ "type": "string",
+ "format": "email"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "additionalProperties": false
+ },
+ "repository": {
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "additionalProperties": false
+ },
+ "homepage": {
+ "type": "string",
+ "format": "uri"
+ },
+ "documentation": {
+ "type": "string",
+ "format": "uri"
+ },
+ "support": {
+ "type": "string",
+ "format": "uri"
+ },
+ "icon": {
+ "type": "string"
+ },
+ "icons": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "src": {
+ "type": "string"
+ },
+ "size": {
+ "type": "string",
+ "pattern": "^\\d+x\\d+$"
+ },
+ "theme": {
+ "type": "string",
+ "minLength": 1
+ }
+ },
+ "required": [
+ "src",
+ "size"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "screenshots": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "localization": {
+ "type": "object",
+ "properties": {
+ "resources": {
+ "type": "string",
+ "pattern": "\\$\\{locale\\}"
+ },
+ "default_locale": {
+ "type": "string",
+ "pattern": "^[A-Za-z0-9]{2,8}(?:-[A-Za-z0-9]{1,8})*$"
+ }
+ },
+ "required": [
+ "resources",
+ "default_locale"
+ ],
+ "additionalProperties": false
+ },
+ "server": {
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "python",
+ "node",
+ "binary"
+ ]
+ },
+ "entry_point": {
+ "type": "string"
+ },
+ "mcp_config": {
+ "type": "object",
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "args": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "env": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "string"
+ }
+ },
+ "platform_overrides": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "object",
+ "properties": {
+ "command": {
+ "$ref": "#/properties/server/properties/mcp_config/properties/command"
+ },
+ "args": {
+ "$ref": "#/properties/server/properties/mcp_config/properties/args"
+ },
+ "env": {
+ "$ref": "#/properties/server/properties/mcp_config/properties/env"
+ }
+ },
+ "additionalProperties": false
+ }
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "type",
+ "entry_point",
+ "mcp_config"
+ ],
+ "additionalProperties": false
+ },
+ "tools": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "description": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "tools_generated": {
+ "type": "boolean"
+ },
+ "prompts": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "description": {
+ "type": "string"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "text": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "text"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "prompts_generated": {
+ "type": "boolean"
+ },
+ "keywords": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "license": {
+ "type": "string"
+ },
+ "privacy_policies": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "compatibility": {
+ "type": "object",
+ "properties": {
+ "claude_desktop": {
+ "type": "string"
+ },
+ "platforms": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "enum": [
+ "darwin",
+ "win32",
+ "linux"
+ ]
+ }
+ },
+ "runtimes": {
+ "type": "object",
+ "properties": {
+ "python": {
+ "type": "string"
+ },
+ "node": {
+ "type": "string"
+ }
+ },
+ "additionalProperties": false
+ }
+ },
+ "additionalProperties": false
+ },
+ "user_config": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "string",
+ "number",
+ "boolean",
+ "directory",
+ "file"
+ ]
+ },
+ "title": {
+ "type": "string"
+ },
+ "description": {
+ "type": "string"
+ },
+ "required": {
+ "type": "boolean"
+ },
+ "default": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "number"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "multiple": {
+ "type": "boolean"
+ },
+ "sensitive": {
+ "type": "boolean"
+ },
+ "min": {
+ "type": "number"
+ },
+ "max": {
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "title",
+ "description"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "_meta": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "object",
+ "additionalProperties": {}
+ }
+ }
+ },
+ "required": [
+ "name",
+ "version",
+ "description",
+ "author",
+ "server"
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/draft-07/schema#"
+}
\ No newline at end of file