Skip to content
MCP server

SandBase Harness

Stdio MCP bridge for SandBase Harness agents, sessions, turns, artifacts, and…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.8
Listing updated
4 days ago

About SandBase Harness

SandBase Harness is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Stdio MCP bridge for SandBase Harness agents, sessions, turns, artifacts, and cancellation.

Install

Run in a terminal

claude mcp add sandbase-harness --env MANAGED_AGENTS_URL='<MANAGED_AGENTS_URL>' --env MANAGED_AGENTS_API_KEY='<MANAGED_AGENTS_API_KEY>' -- docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sandbase-harness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGED_AGENTS_URL",
        "-e",
        "MANAGED_AGENTS_API_KEY",
        "ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
      ],
      "env": {
        "MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
        "MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sandbase-harness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGED_AGENTS_URL",
        "-e",
        "MANAGED_AGENTS_API_KEY",
        "ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
      ],
      "env": {
        "MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
        "MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "sandbase-harness": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGED_AGENTS_URL",
        "-e",
        "MANAGED_AGENTS_API_KEY",
        "ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
      ],
      "env": {
        "MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
        "MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sandbase-harness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGED_AGENTS_URL",
        "-e",
        "MANAGED_AGENTS_API_KEY",
        "ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
      ],
      "env": {
        "MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
        "MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sandbase-harness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGED_AGENTS_URL",
        "-e",
        "MANAGED_AGENTS_API_KEY",
        "ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"
      ],
      "env": {
        "MANAGED_AGENTS_URL": "<MANAGED_AGENTS_URL>",
        "MANAGED_AGENTS_API_KEY": "<MANAGED_AGENTS_API_KEY>"
      }
    }
  }
}

Configuration

  • MANAGED_AGENTS_URLURL of the SandBase Harness runtime API.Required
  • MANAGED_AGENTS_API_KEYAPI key when the connected Harness runtime requires authentication.

Pricing

Open source

SandBase Harness FAQ

Is SandBase Harness free?

Yes. SandBase Harness is open source, so you can use and self-host it for free.

How do I add SandBase Harness to Claude Code?

Run this command in your terminal: claude mcp add sandbase-harness --env MANAGED_AGENTS_URL='<MANAGED_AGENTS_URL>' --env MANAGED_AGENTS_API_KEY='<MANAGED_AGENTS_API_KEY>' -- docker run -i --rm -e MANAGED_AGENTS_URL -e MANAGED_AGENTS_API_KEY ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8