Skip to main content
MCP server CX Codex

polarion-mcp — Claude Code MCP server: what it does, how to install

MCP server for Claude Code and Codex connecting AI agents to the Polarion ALM REST API. Finds requirements, inspects LiveDocs, and prepares test runs.

MIT ★ 6 updated 2026-11-15

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add polarion-mcp -e API_BASE_URL=<API_BASE_URL> -e BEARER_TOKEN=<BEARER_TOKEN> -- npx -y polarion-mcp
Open on GitHub

What polarion-mcp does

The server converts client tool calls into Polarion REST requests, exposing 284 tools. It lets agents query requirements, defect records, document contents, and traceability links using operations like getWorkItems and getLinkedWorkItems.

Write operations support dry runs via dry_run: true before applying modifications. Setting MCP_READ_ONLY=1 blocks all write actions. The server does not execute tests directly: it creates run definitions and records test outcomes supplied by the user.

Running the connector requires a Polarion instance with REST enabled, a personal token in BEARER_TOKEN, the host address in API_BASE_URL, and Node.js 22 or newer.

What it helps with

  • locate requirements lacking verification links
  • inspect LiveDoc sections and propose text revisions
  • draft test cases and structure new test runs
  • filter open blocking defects for an upcoming release

Example prompts for the agent

  • Find requirements without a verifies link to a test case.
  • Which open defects could block this release plan?

How to install polarion-mcp

Platform CLI

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

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about polarion-mcp

How to install polarion-mcp in Claude Code?

Run claude mcp add polarion-mcp -e API_BASE_URL=<API_BASE_URL> -e BEARER_TOKEN=<BEARER_TOKEN> -- npx -y polarion-mcp.

What does polarion-mcp do?

It exposes Polarion ALM REST operations to your assistant for searching requirements, inspecting LiveDocs, evaluating traceability, and managing test runs.

What is required to run polarion-mcp?

You need a REST-enabled Polarion instance, a personal access token for BEARER_TOKEN, the server URL in API_BASE_URL, and Node.js 22+.

Similar MCP servers

All MCP servers for Testing and QA →

Project sponsors

Companies that keep this analytics open