Harness MCP Server

The Harness MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with Harness APIs, enabling advanced automation and interaction capabilities for developers and tools.

Components

Tools

The server implements several toolsets:

Pipelines Toolset

Toolset Name: pipelines

• get_pipeline: Get details of a specific pipeline
• list_pipelines: List pipelines in a repository
• get_execution: Get details of a specific pipeline execution
• list_executions: List pipeline executions
• fetch_execution_url: Fetch the execution URL for a pipeline execution

Pull Requests Toolset

Toolset Name: pullrequests

• get_pull_request: Get details of a specific pull request
• list_pull_requests: List pull requests in a repository
• get_pull_request_checks: Get status checks for a specific pull request
• get_pull_request_activities: Get activities and comments for a specific pull request
• create_pull_request: Create a new pull request

Repositories Toolset

Toolset Name: repositories

• get_repository: Get details of a specific repository
• list_repositories: List repositories

Registries Toolset

Toolset Name: registries

• get_registry: Get details of a specific registry in Harness artifact registry
• list_artifact_files: List files for a specific artifact version in a Harness artifact registry
• list_artifact_versions: List artifact versions in a Harness artifact registry
• list_artifacts: List artifacts in a Harness artifact registry
• list_registries: List registries in Harness artifact registry

Dashboards Toolset

Toolset Name: dashboards

• list_dashboards: Lists all available Harness dashboards
• get_dashboard_data: Retrieves the data from a specific Harness dashboard

Cloud Cost Management Toolset

Toolset Name: cloudcostmanagement

• get_ccm_overview: Retrieve the cost overview for a specific account.
• list_ccm_cost_categories: List all cost categories names for a specified account.
• list_ccm_cost_categories_detail: List all cost categories details for a specified account.
• get_ccm_cost_category: Retrieve a cost category detail by Id for a specified account.

Logs Toolset

Toolset Name: logs

• download_execution_logs: Download logs for a pipeline execution

Prerequisites

1. You will need to have Go 1.23 or later installed on your system.
2. A Harness API key for authentication.

Quickstart

Makefile Usage

This project provides a Makefile to simplify common development tasks. The main targets are:

• make build – Build the mcp-server binary with version information embedded.
• make init – Set up git hooks and submodules for pre-commit checks.
• make dep – Download Go module dependencies.
• make tools – Install tools required for the build (if any are specified).
• make format – Format Go code using goimports and gci.

You can run any of these commands from the project root. For example:

make build
make format

Build from Source

1. Clone the repository:

git clone https://github.com/harness/mcp-server.git
cd mcp-server

2. Build the binary:

go build -o cmd/harness-mcp-server/harness-mcp-server ./cmd/harness-mcp-server

3. Run the server:

HARNESS_API_KEY=your_api_key HARNESS_DEFAULT_ORG_ID=your_org_id HARNESS_DEFAULT_PROJECT_ID=your_project_id ./cmd/harness-mcp-server/harness-mcp-server stdio

Use Docker Image

Alternatively, you can use the pre-built Docker image:

docker run -i --rm \
  -e HARNESS_API_KEY=your_api_key \
  -e HARNESS_DEFAULT_ORG_ID=your_org_id \
  -e HARNESS_DEFAULT_PROJECT_ID=your_project_id \
  -e HARNESS_BASE_URL=your_base_url \
  harness/mcp-server stdio

Claude Desktop Configuration

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "harness": {
      "command": "/path/to/harness-mcp-server",
      "args": ["stdio"],
      "env": {
        "HARNESS_API_KEY": "<YOUR_API_KEY>",
        "HARNESS_DEFAULT_ORG_ID": "<YOUR_ORG_ID>",
        "HARNESS_DEFAULT_PROJECT_ID": "<YOUR_PROJECT_ID>"
      }
    }
  }
}

Usage with Claude Code

HARNESS_API_KEY=your_api_key HARNESS_ACCOUNT_ID=your_account_id HARNESS_ORG_ID=your_org_id HARNESS_PROJECT_ID=your_project_id ./cmd/harness-mcp-server/harness-mcp-server stdio

Usage with Windsurf

To use the Harness MCP Server with Windsurf:

1. Add the server configuration to your Windsurf config file:

Using Local Binary

{
  "mcpServers": {
    "harness": {
      "command": "/path/to/harness-mcp-server",
      "args": ["stdio"],
      "env": {
        "HARNESS_API_KEY": "<YOUR_API_KEY>",
        "HARNESS_DEFAULT_ORG_ID": "<YOUR_ORG_ID>",
        "HARNESS_DEFAULT_PROJECT_ID": "<YOUR_PROJECT_ID>",
        "HARNESS_BASE_URL": "<YOUR_BASE_URL>"
      }
    }
  }
}

Using Docker Image

{
  "mcpServers": {
    "harness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HARNESS_API_KEY",
        "-e",
        "HARNESS_DEFAULT_ORG_ID",
        "-e",
        "HARNESS_DEFAULT_PROJECT_ID",
        "-e",
        "HARNESS_BASE_URL",
        "harness/mcp-server",
        "stdio"
      ],
      "env": {
        "HARNESS_API_KEY": "<YOUR_API_KEY>",
        "HARNESS_DEFAULT_ORG_ID": "<YOUR_ORG_ID>",
        "HARNESS_DEFAULT_PROJECT_ID": "<YOUR_PROJECT_ID>",
        "HARNESS_BASE_URL": "<YOUR_BASE_URL>"
      }
    }
  }
}

Usage with Amazon Q Developer CLI

To use the Harness MCP Server with Amazon Q Developer CLI:

1. Add the server configuration to your Amazon Q config file at: ~/.aws/amazonq/mcp.json

Using Local Binary

{
  "mcpServers": {
    "harness": {
      "command": "/path/to/harness-mcp-server",
      "args": ["stdio"],
      "env": {
        "HARNESS_API_KEY": "<YOUR_API_KEY>",
        "HARNESS_DEFAULT_ORG_ID": "<YOUR_ORG_ID>",
        "HARNESS_DEFAULT_PROJECT_ID": "<YOUR_PROJECT_ID>",
        "HARNESS_BASE_URL": "<YOUR_BASE_URL>"
      }
    }
  }
}

Cursor Configuration

{
  "mcpServers": {
    "harness": {
      "command": "/path/to/harness-mcp-server",
      "args": ["stdio"],
      "env": {
        "HARNESS_API_KEY": "your_api_key",
        "HARNESS_DEFAULT_ORG_ID": "your_org_id",
        "HARNESS_DEFAULT_PROJECT_ID": "your_project_id",
        "HARNESS_BASE_URL": "<if-needed>"
      }
    }
  }
}

Cursor MCP Guide

VS Code Configuration

{
  "mcp": {
    "servers": {
      "harness": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "HARNESS_API_KEY",
          "-e",
          "HARNESS_DEFAULT_ORG_ID",
          "-e",
          "HARNESS_DEFAULT_PROJECT_ID",
          "-e",
          "HARNESS_BASE_URL",
          "harness/mcp-server",
          "stdio"
        ],
        "env": {
          "HARNESS_API_KEY": "<YOUR_API_KEY>",
          "HARNESS_DEFAULT_ORG_ID": "<YOUR_ORG_ID>",
          "HARNESS_DEFAULT_PROJECT_ID": "<YOUR_PROJECT_ID>",
          "HARNESS_BASE_URL": "<YOUR_BASE_URL>"
        }
      }
    }
  }
}

VS Code MCP Guide

Development

Command Line Arguments

The Harness MCP Server supports the following command line arguments:

• --toolsets: Comma-separated list of tool groups to enable (default: "all")
• --read-only: Run the server in read-only mode
• --log-file: Path to log file for debugging
• --log-level: Set the logging level (debug, info, warn, error)
• --version: Show version information
• --help: Show help message
• --base-url: Base URL for Harness (default: "https://app.harness.io")

Environment Variables

Environment variables are prefixed with HARNESS_:

• HARNESS_API_KEY: Harness API key (required) - Account ID is automatically extracted from the API key
• HARNESS_DEFAULT_ORG_ID: Default Harness organization ID (optional, if not specified it would need to be passed in the request if it's required for that operation)
• HARNESS_DEFAULT_PROJECT_ID: Default Harness project ID (optional, if not specified it would need to be passed in the request if it's required for that operation)
• HARNESS_TOOLSETS: Comma-separated list of toolsets to enable (default: "all")
• HARNESS_READ_ONLY: Set to "true" to run in read-only mode
• HARNESS_LOG_FILE: Path to log file
• HARNESS_LOG_LEVEL: Set the logging level (debug, info, warn, error)
• HARNESS_BASE_URL: Base URL for Harness (default: "https://app.harness.io")

Authentication

The server uses a Harness API key for authentication. This can be set via the HARNESS_API_KEY environment variable.

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector with this command:

npx @modelcontextprotocol/inspector /path/to/harness-mcp-server stdio

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.