Polarion MCP
Query and update Polarion ALM requirements, test runs and LiveDocs from your AI assistant
- 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-mcpAdd 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/v1RequiredBEARER_TOKENPersonal Access Token (PAT) for authenticating with the Polarion REST APIRequiredAPI_BASE_URLBase URL for the Polarion REST API, e.g. https://your-polarion-server.com/polarion/rest/v1RequiredBEARER_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.


