MCP server for Polarion ALM — read and write documents and work items
MCP server for Polarion ALM — read and write documents and work items
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 automatically paced to Polarion's rate limits — so an AI assistant can work on production data without surprises.
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): ```bash
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| 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 |
| 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 |
{
"mcpServers": {
"mcp-server-polarion": {
"command": "uvx",
"args": [
"mcp-server-polarion"
],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "YOUR_POLARION_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
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): ```bash
| Variable | Description | Required |
|---|---|---|
| POLARION_URL | Declared in the maintainer’s client configuration. | Check documentation |
| POLARION_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.