# Harness

> Harness is an open-source MCP server for developer tools. MCP server giving AI clients access to the Harness delivery and cloud cost APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/asklokesh/harness-mcp-server
- **MCP Registry name:** io.github.asklokesh/harness-mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Model Context Protocol server that connects Harness, a continuous delivery and cloud cost management platform, to GenAI applications. It runs over stdio and is distributed as a Python package installable with pip, with an option to install from a cloned repository.

Access is controlled by a Harness API key supplied through an environment variable, with an optional variable for the API URL. The README mentions multiple authentication methods, rate limiting and retry handling, and async support, but it does not list the individual API endpoints or MCP tools the server exposes.

It suits developers and platform teams who want an AI assistant to query or act on their Harness account through MCP. The project is at an early 0.1.0 release and is published under the MIT license.

## Features

- **Stdio transport:** Runs as a local MCP server over standard input and output for compatible AI clients.
- **Harness API access:** Wraps Harness API calls so an AI client can work with a Harness account.
- **Configurable authentication:** Reads a required API key and an optional API URL from environment variables.
- **Rate limiting and retries:** The README cites built-in rate limiting and retry logic for API calls.
- **Async support:** The README says the server supports asynchronous operation.

## Good for

- Asking an AI assistant about Harness pipelines and deployments from within a chat or IDE
- Automating routine Harness API queries through an MCP-enabled agent
- Reviewing cloud cost information from Harness via an AI client

## Install

### Claude Code (Terminal)

```sh
claude mcp add harness-mcp-server --env HARNESS_API_KEY='<HARNESS_API_KEY>' -- uvx harness-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "harness-mcp-server": {
      "command": "uvx",
      "args": [
        "harness-mcp-server"
      ],
      "env": {
        "HARNESS_API_KEY": "<HARNESS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "harness-mcp-server": {
      "command": "uvx",
      "args": [
        "harness-mcp-server"
      ],
      "env": {
        "HARNESS_API_KEY": "<HARNESS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "harness-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "harness-mcp-server"
      ],
      "env": {
        "HARNESS_API_KEY": "<HARNESS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "harness-mcp-server": {
      "command": "uvx",
      "args": [
        "harness-mcp-server"
      ],
      "env": {
        "HARNESS_API_KEY": "<HARNESS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "harness-mcp-server": {
      "command": "uvx",
      "args": [
        "harness-mcp-server"
      ],
      "env": {
        "HARNESS_API_KEY": "<HARNESS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How is the server installed?

The README gives pip install harness-mcp-server, or installing from the GitHub source with pip install -e.

### What credentials does it need?

The registry entry lists HARNESS_API_KEY as a required secret and HARNESS_API_URL as an optional variable.

### What license does it use?

The README states the project is released under the MIT License.

### Is Harness free?

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

### How do I add Harness to Claude Code?

Run this command in your terminal: claude mcp add harness-mcp-server --env HARNESS_API_KEY='<HARNESS_API_KEY>' -- uvx harness-mcp-server

### What are the best alternatives to Harness?

The closest alternatives to Harness are Uipath, Rundeck, fastapi_mcp, MCP-Bridge and MCP Foundry — Build, Test & Publish MCP Servers.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Uipath](https://ai-powered.com/mcp/uipath): Uipath is an open-source MCP server for developer tools.
- [Rundeck](https://ai-powered.com/mcp/rundeck): Rundeck is an open-source MCP server for developer tools.
- [fastapi_mcp](https://ai-powered.com/mcp/fastapi-mcp): fastapi_mcp is an open-source MCP server for ai models and llm tooling.
- [MCP-Bridge](https://ai-powered.com/mcp/mcp-bridge-2): MCP-Bridge is an open-source MCP server for ai models and llm tooling.
- [MCP Foundry — Build, Test & Publish MCP Servers](https://ai-powered.com/mcp/mcp-foundry-build-test-and-publish-mcp-servers): MCP Foundry — Build, Test & Publish MCP Servers is a freemium MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [mcp-gateway (OpenAPI to MCP)](https://ai-powered.com/mcp/mcp-gateway-openapi-to-mcp): mcp-gateway (OpenAPI to MCP) is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/harness-2
