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
claude mcp add polarion-mcp -e API_BASE_URL=<API_BASE_URL> -e BEARER_TOKEN=<BEARER_TOKEN> -- npx -y polarion-mcpWhat 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-mcpReplace <…> with your own values
Platform CLI
codex mcp add polarion-mcp --env API_BASE_URL=<API_BASE_URL> --env BEARER_TOKEN=<BEARER_TOKEN> -- npx -y polarion-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"polarion-mcp": {
"command": "npx",
"args": [
"-y",
"polarion-mcp"
],
"env": {
"API_BASE_URL": "<API_BASE_URL>",
"BEARER_TOKEN": "<BEARER_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"polarion-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"polarion-mcp"
],
"env": {
"API_BASE_URL": "<API_BASE_URL>",
"BEARER_TOKEN": "<BEARER_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e API_BASE_URL=<API_BASE_URL> -e BEARER_TOKEN=<BEARER_TOKEN> polarion-mcp npx -y polarion-mcpReplace <…> 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+.