polarionalmproduct-managementwork-itemstraceability
MCP server for Polarion ALM enabling read/write access to documents, work items, test runs, traceability links, and comments.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
We couldn’t automatically confirm this listing starts correctly
We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.
uvx mcp-server-polarionNo response to initialize.
This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 3d ago.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Render Polarion documents as Markdown for AI processing
Search and list work items or test runs using Lucene or SQL queries
Create or update work items, documents, and test runs programmatically
Manage traceability links and comments within Polarion projects
Validate changes with dry-run before committing to Polarion
Key features
46 read/write tools covering documents, work items, test runs, links, comments, attachments
Document rendering to Markdown and raw HTML access
Search with Lucene and SQL queries
Safe writes with dry-run and pre-write validation of fields and enums
Request pacing with configurable rate limits and automatic retries
Pagination support on all list tools
Capabilities & Tool Schemas (46)
Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Server Polarion.
list_projectsList accessible projects
list_documentsList documents in a project
list_work_itemsList work items in a project (Lucene/SQL query)
list_test_runsList test runs in a project (Lucene query, templates filter)
get_test_runGet test run details, optionally with the raw HTML report body
list_test_recordsList a test run's execution records, one per test case iteration
Documentation Overview
mcp-server-polarion
Talk to your Polarion — AI reads, writes, and reorganizes documents, work items, test runs, and traceability links.
Features · Quickstart · Tools · Example Prompts · Setup
A Model Context Protocol (MCP) server for Polarion ALM, built for real-world instances: every write supports dry_run, guards validate fields and enum values before anything is committed, and requests are paced to a rate cap you configure for your instance — so an AI assistant can work on production data without surprises.
Features
- 46 tools covering read and write across documents, work items, test runs, traceability links, comments, and attachments.
- Read — render documents as Markdown, search with Lucene or SQL, walk incoming/outgoing links, resolve enum options.
- Write — create and update work items, documents, and test runs, manage links, reorganize document structure, post comments.
- Safe writes — every write tool supports
dry_run, and pre-write guards validate fields, enum values, and link targets before hitting Polarion. - Plays nice with your server — requests are serialized and paced to a configurable rate cap, with automatic retries on 429/5xx responses.
- Built for LLMs — strict async, fully typed, pagination on every list tool, docstrings written as the assistant's manual.
Quickstart
Requires Polarion 2506+ and uv — see Prerequisites. Fastest path — Claude Code:
Other clients (VS Code, Claude Desktop, Cursor) — see Client Configuration.
Tools
Read
| Tool | Description |
|---|---|
list_projects | List accessible projects |
list_documents | List documents in a project |
list_work_items | List work items in a project (Lucene/SQL query) |
list_test_runs | List test runs in a project (Lucene query, templates filter) |
get_test_run | Get test run details, optionally with the raw HTML report body |
list_test_records | List a test run's execution records, one per test case iteration |
get_test_record | Get one test record's execution comment and test-case revision |
get_sql_query_recipes | Fetch copy-paste SQL recipes for advanced queries |
get_html_recipes | Fetch copy-paste Polarion HTML templates for raw-HTML body edits |
get_document | Get document metadata, optionally with the raw body HTML |
read_document | Render a document end-to-end as Markdown |
read_document_parts | List a document's structural parts with embedded work item metadata |
get_work_item | Get work item details with the body as raw HTML |
read_work_item | Get work item details with the body as Markdown |
list_work_item_links | List a work item's outgoing or incoming links |
list_document_attachments | List a document's attachments with file name, size, and author |
get_document_attachment_content | Fetch an image attachment for viewing (bitmap as image, SVG as text) |
list_work_item_attachments | List a work item's attachments with file name, size, and author |
get_work_item_attachment_content | Fetch a work item image attachment for viewing (bitmap as image, SVG as text) |
list_test_record_attachments | List a test record's attachments with file name, size, and author |
get_test_record_attachment_content | Fetch a test record image attachment for viewing (bitmap as image, SVG as text) |
list_document_comments | List a document's comments with thread relationships |
list_work_item_comments | List a work item's comments with thread relationships |
list_document_enum_options | Resolve valid enum ids for a document field |
list_work_item_enum_options | Resolve valid enum ids for a work item field |
All list tools support pagination via page_size (1–100) and page_number parameters.
Write
| Tool | Description |
|---|---|
create_work_items | Create one or more work items in a single request |
update_work_items | Update fields, body, or workflow status on one or more work items |
create_document | Create a new document |
update_document | Update document metadata, body, or workflow status |
copy_document | Copy a document to a new name, space, or project |
create_test_runs | Create one or more test runs, optionally from a template |
create_test_records | Record test-case execution results on a test run |
update_test_runs | Update title, status, group, or custom fields on one or more test runs |
update_test_records | Update result, comment, or defect link on one or more test records of a test run |
create_work_item_links | Create one or more outgoing links from a source work item |
update_work_item_link | Update suspect / revision on one outgoing link |
delete_work_item_links | Delete one or more outgoing links from a source work item |
move_work_item_to_document | Attach a work item to a document at a chosen position |
move_work_item_from_document | Detach a work item from its document |
create_document_attachments | Upload one or more local files as document attachments |
create_work_item_attachments | Upload one or more local files as work item attachments |
create_test_record_attachments | Upload one or more local files as test record attachments |
create_document_comments | Add one or more comments or replies to a document |
create_work_item_comments | Add one or more comments or replies to a work item |
update_document_comment | Resolve or re-open a document comment |
update_work_item_comment | Resolve or re-open a work item comment |
Example Prompts
Discovery & search
"List the projects I can access, then show the documents in project MCPT with their types."
"List the documents in space 'Specifications' of project MCPT."
"Find every approved requirement in project MCPT whose title starts with 'Auth' and show me their owning document."
"Search project MCPT for work items where the custom field 'verification_method' is 'Test' — grab the SQL recipes first if you need a join."
"Find all work items in the SRS module of project MCPT that were changed in the last sprint."
Reading & summarizing
"Read the SRS document of project MCPT and summarize each open requirement."
"Show me the structural outline of the SRS document — headings and the work items under each."
"Read work item MCPT-042 as Markdown and explain what it asks for."
"Show the outgoing and incoming links for MCPT-042 and flag any child task that is still open."
"Which requirements in the SRS document have no 'verifies' back link from a test case?"
"List the open comment threads on the SRS document and who started each."
Creating & editing
"Create a task in project MCPT titled 'Refactor authentication module' and link it to MCPT-042 as 'relates_to'."
"Create three test-case work items in project MCPT from this checklist and link each one to MCPT-042 as 'verifies'."
"Add a new requirement under section 3.2 of the SRS document with the body I just drafted."
"Update the description of MCPT-042 with the revised text I'll paste, keeping the existing formatting."
"Add a comment on the SRS document asking the owner to clarify section 4, then reply to thread T-12 marking it resolved."
"Create a test run REG-SPRINT-7 in project MCPT from the 'Regression' template with status 'open'."
Workflow & reorganization
"List the valid status values for a defect in project MCPT, then move MCPT-077 to 'in_review'."
"Bump MCPT-042's priority to 90, set severity to 'major', and approve the workflow."
"Change MCPT-201 from a task to a requirement and re-apply its previous status."
"Move MCPT-201 into the SRS document right after MCPT-150."
"Detach MCPT-077 from its document so I can rework it as a standalone task."
"Mark the 'blocks' link from MCPT-042 to MCPT-099 as suspect, then delete the stale 'relates_to' link to MCPT-010."
Setup
Prerequisites
Polarion 2506 or higher is required. Earlier versions lack REST API endpoints this server depends on.
This server is distributed as a Python package and requires uv to run.
Install uv (if not already installed):
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
13
Stargazers on the source repository.
Last commit
2d ago
Most recent push to the default branch.
Install check
Inconclusive
Didn't respond in our test window — often a slow first install.
Tools exposed
46
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MCP Server Polarion
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/devemberx-mcp-server-polarion)HTML Embed
<a href="https://allmcps.com/mcp/devemberx-mcp-server-polarion"><img src="https://allmcps.com/api/badge/devemberx-mcp-server-polarion?style=directory" alt="MCP Server Polarion on AllMCPs" /></a>Technical Specs & Signals
CategoryProduct Management
PricingBring your own API key (usage-based cost)
11/11 checks healthy over the last 32d
61Quality signal: Good · 61/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools30/30
Adoption & activity6/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 22d ago via OSV.dev · mcp-server-polarion (PyPI)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.