Skip to content
MCP server

Polarion MCP

Query and update Polarion ALM requirements, test runs and LiveDocs from your AI assistant

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.5.0
Listing updated
today

Similar MCP servers

About Polarion MCP

Polarion MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • API_BASE_URLBase URL for the Polarion REST API, e.g. https://your-polarion-server.com/polarion/rest/v1Required
  • BEARER_TOKENPersonal Access Token (PAT) for authenticating with the Polarion REST APIRequired
  • API_BASE_URLBase URL for the Polarion REST API, e.g. https://your-polarion-server.com/polarion/rest/v1Required
  • BEARER_TOKENPersonal Access Token (PAT) for authenticating with the Polarion REST APIRequired

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licensed; requires your own Polarion instance

Polarion MCP 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.

How AIPoweredBot checks servers