# Polarion MCP

> Polarion MCP is an open-source MCP server for developer tools. Query and update Polarion ALM requirements, test runs and LiveDocs from your AI assistant. It runs locally on your machine and is started by your AI client.

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

## About

The server wraps Polarion's REST API and exposes every operation, which the README puts at 284 tools generated from the current API definition. It covers work items, LiveDocs and their parts, test runs and records, plans and collections, plus projects, users and allowed field values.

Writes are guarded. Passing dry_run true previews a change, supported work item and LiveDoc writes are verified by reading them back, and setting MCP_READ_ONLY=1 blocks all writes. The README adds that previews do not create an approval lock, so approval rules belong in the AI client. It also states the connector does not execute product tests; it drafts cases and records results you supply.

Setup needs a REST-enabled Polarion instance, an API base URL and a personal access token. It runs locally via npx or a Python launcher, or as a Docker server for cloud clients such as claude.ai and ChatGPT. The code is MIT with signed container images.

## Features

- **Full REST coverage:** 284 tools generated from Polarion's API.
- **Work item search:** Find requirements and triage defects.
- **LiveDoc reading:** Read documents and inspect their parts.
- **Test management:** Prepare runs and record supplied results.
- **Dry-run previews:** Preview writes before saving.
- **Read-only mode:** MCP_READ_ONLY=1 blocks every write.

## Good for

- List open defects that could block a release
- Propose clearer acceptance criteria for a requirement
- Find requirements with no verifying test case
- Summarize a release plan and its latest test runs

## Install

### Claude Code (Terminal)

```sh
claude mcp add polarion-mcp --env API_BASE_URL='<API_BASE_URL>' --env BEARER_TOKEN='<BEARER_TOKEN>' -- npx -y polarion-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "polarion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polarion-mcp"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "BEARER_TOKEN": "<BEARER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "polarion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polarion-mcp"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "BEARER_TOKEN": "<BEARER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "polarion-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "polarion-mcp"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "BEARER_TOKEN": "<BEARER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "polarion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polarion-mcp"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "BEARER_TOKEN": "<BEARER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "polarion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polarion-mcp"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "BEARER_TOKEN": "<BEARER_TOKEN>"
      }
    }
  }
}
```

## Tools

- `getWorkItems`: Search and list work items.
- `getWorkItem`: Read one work item.
- `patchWorkItem`: Update a work item.
- `postWorkItems`: Create work items.
- `getDocument`: Read a LiveDoc.
- `getDocumentParts`: Read the parts of a document.
- `getLinkedWorkItems`: Inspect traceability links.
- `getPlan`: Read a release plan.
- `getTestRuns`: List test runs.
- `postTestRuns`: Create test runs.
- `postTestRecords`: Record test results.

## FAQ

### What do I need to connect?

A REST-enabled Polarion instance, its API base URL and a personal access token.

### Can I prevent writes?

Yes, set MCP_READ_ONLY=1.

### Can it run tests?

No, it only records results you supply.

### Does it work with cloud clients?

Yes, via the Docker server setup.

### Is Polarion MCP free?

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

### How do I add Polarion MCP to Claude Code?

Run this command in your terminal: claude mcp add polarion-mcp --env API_BASE_URL='<API_BASE_URL>' --env BEARER_TOKEN='<BEARER_TOKEN>' -- npx -y polarion-mcp

### What are the best alternatives to Polarion MCP?

The closest alternatives to Polarion MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source 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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/polarion-mcp
