Polarion MCP Server

Model Context Protocol (MCP) server for Siemens Polarion requirements management.

Quick Start

Install

pip install polarion-mcp

Configure in Cursor

Edit mcp.json:

{
  "mcpServers": {
    "polarion": {
      "command": "polarion-mcp"
    }
  }
}

Authenticate

In Cursor chat:

Open Polarion login
Set Polarion token: <your-token>

Connect to Your Polarion Instance

Default: http://dev.polarion.atoms.tech/polarion

To use your own instance, set environment variable:

export POLARION_BASE_URL="https://your-polarion.com/polarion"

Or in mcp.json:

{
  "mcpServers": {
    "polarion": {
      "command": "polarion-mcp",
      "env": {
        "POLARION_BASE_URL": "https://your-polarion.com/polarion"
      }
    }
  }
}

Available Tools

Authentication

Open Polarion login - Open browser login
Set Polarion token: <token> - Save token
Check Polarion status - Verify auth

Projects

Get Polarion projects - List all projects
Get Polarion project: PROJECT_ID - Get project details

Work Items

Get Polarion work items: PROJECT_ID - List items
Get Polarion work items: PROJECT_ID (query: "type:requirement") - Filter
Get Polarion work item: PROJECT_ID ITEM_ID - Get details

Documents

Get Polarion document: PROJECT_ID SPACE_ID DOCUMENT_NAME - Access documents

Connect to URL-based Server (Claude Desktop)

For servers accessible via URL (e.g., GCP deployment):

Install mcp-remote:

npm install -g mcp-remote

Configure claude_desktop_config.json:

{
  "mcpServers": {
    "polarion-demo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://YOUR_SERVER_IP:8080/sse"]
    }
  }
}

Important: Use the VM's IP address (e.g., 35.209.32.163), not the domain name. Domain names will fail with "Invalid Host header" error.

Troubleshooting

Can't connect?

Verify POLARION_BASE_URL is correct
Check Polarion instance is accessible
Verify token hasn't expired

"Invalid Host header" error?

Use IP address, not domain name in connections
✅ http://35.209.32.163:8080/sse (works)
❌ http://dev.polarion.atoms.tech:8080/sse (fails)
This is a FastMCP limitation - it validates Host headers strictly

Authentication failed?

Regenerate token in Polarion
Use: Open Polarion login → Set Polarion token

Resources

GitHub: https://github.com/Sdunga1/MCP-Polarion
PyPI: https://pypi.org/project/polarion-mcp

License

MIT

Metadata

Release files for polarion-mcp 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for polarion-mcp 3.0.0
File	Interpreter	ABI	Platform	Reset
polarion_mcp-3.0.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.3 MB Feb 8, 2026	CPython 3.13	CPython 3.13	Linux glibc 2.17+ x86-64	Details
polarion_mcp-3.0.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 2.3 MB Feb 8, 2026	CPython 3.13	CPython 3.13	Linux glibc 2.17+ ARM64	Details
polarion_mcp-3.0.0-cp313-cp313-macosx_11_0_arm64.whl 382.7 kB Feb 8, 2026	CPython 3.13	CPython 3.13	macOS 11.0+ ARM64	Details
polarion_mcp-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.4 MB Feb 8, 2026	CPython 3.12	CPython 3.12	Linux glibc 2.17+ x86-64	Details
polarion_mcp-3.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 2.3 MB Feb 8, 2026	CPython 3.12	CPython 3.12	Linux glibc 2.17+ ARM64	Details
polarion_mcp-3.0.0-cp312-cp312-macosx_11_0_arm64.whl 386.1 kB Feb 8, 2026	CPython 3.12	CPython 3.12	macOS 11.0+ ARM64	Details
polarion_mcp-3.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.3 MB Feb 8, 2026	CPython 3.11	CPython 3.11	Linux glibc 2.17+ x86-64	Details
polarion_mcp-3.0.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 2.3 MB Feb 8, 2026	CPython 3.11	CPython 3.11	Linux glibc 2.17+ ARM64	Details
polarion_mcp-3.0.0-cp311-cp311-macosx_11_0_arm64.whl 386.2 kB Feb 8, 2026	CPython 3.11	CPython 3.11	macOS 11.0+ ARM64	Details
polarion_mcp-3.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.2 MB Feb 8, 2026	CPython 3.10	CPython 3.10	Linux glibc 2.17+ x86-64	Details
polarion_mcp-3.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 2.2 MB Feb 8, 2026	CPython 3.10	CPython 3.10	Linux glibc 2.17+ ARM64	Details
polarion_mcp-3.0.0-cp310-cp310-macosx_11_0_arm64.whl 389.5 kB Feb 8, 2026	CPython 3.10	CPython 3.10	macOS 11.0+ ARM64	Details

Total release size: 19.8 MB

Release files / polarion_mcp-3.0.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	polarion_mcp-3.0.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.3 MB
Tags	CPython 3.13 Linux glibc 2.17+ x86-64
SHA-256 checksum How to use checksums	`a834cb2b144f2f7d8d4ade352d3c6b6eb5672422a8896beb182716be8fbffada`
BLAKE2b-256 checksum How to use checksums	`ad1ef71ea6dac63a1fb5a9ddcdcb8a2a31fe438849f4b8d41f06e587994186f4`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	polarion_mcp-3.0.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	2.3 MB
Tags	CPython 3.13 Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`1f909832f38eb48dbcdca7bf6f7611391151e93e4bc7c869efccaff444a8d728`
BLAKE2b-256 checksum How to use checksums	`70b273a345457f347d084504afeed522e915ec63d19c9ae16a00a04c06276eb5`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp313-cp313-macosx_11_0_arm64.whl

Download URL	polarion_mcp-3.0.0-cp313-cp313-macosx_11_0_arm64.whl
Size	382.7 kB
Tags	CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`f73c0d30a462074d4a863716e5a09e7da64a90e7740d846d8363a5b2da9713ee`
BLAKE2b-256 checksum How to use checksums	`5bede85e4e3843452d27e94760b1c1ccc9ba90118a4756925b7554e1a640bfed`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	polarion_mcp-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.4 MB
Tags	CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum How to use checksums	`529a0b1708d14c2c4a5c892b1178b3ff190b89ec98fa68c4009c22fe6bc0e3bb`
BLAKE2b-256 checksum How to use checksums	`ebac458410c7c5c806001099eb6289b7b952aac0e9a964531de62207516901df`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	polarion_mcp-3.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	2.3 MB
Tags	CPython 3.12 Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`c2e6e69696a224d2d1a568fd970815d9a36652a69383d17c696ef0aaf2adef68`
BLAKE2b-256 checksum How to use checksums	`8cd9f15371bad9bf4888ca60a9dbfef5baf8578be8475c2a8085e9f1f6c87c2e`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp312-cp312-macosx_11_0_arm64.whl

Download URL	polarion_mcp-3.0.0-cp312-cp312-macosx_11_0_arm64.whl
Size	386.1 kB
Tags	CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`6f0aea324452bf3fd885fb84de4987968b7a936ca1577db29a8b06fc2770eabd`
BLAKE2b-256 checksum How to use checksums	`1d9567a110071f8d4abc43ef74a5ed57e23456da69ecc6bef4acc14f2c16c345`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	polarion_mcp-3.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.3 MB
Tags	CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum How to use checksums	`aa9eab860473e3b533090d74d439d91a485cfb770d2f6b17047f0f2cfcfab3a5`
BLAKE2b-256 checksum How to use checksums	`9da1affc458ea363f2a325525207de4ec13161146a85734e2a771fe3560918ab`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	polarion_mcp-3.0.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	2.3 MB
Tags	CPython 3.11 Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`626991a6a3b60774adf6e88c36f1e5fbc44835d8fc3147ac854aef2ca5c89ff9`
BLAKE2b-256 checksum How to use checksums	`d6d13cf9cf0e7ae7592a602f157f77f283d002a15b986f9257d49c6074342852`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp311-cp311-macosx_11_0_arm64.whl

Download URL	polarion_mcp-3.0.0-cp311-cp311-macosx_11_0_arm64.whl
Size	386.2 kB
Tags	CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`9f624ebe3a59cfbbe2217de064045bced3c0e2420bc8ff70e3a42532f4bf601c`
BLAKE2b-256 checksum How to use checksums	`2495b654ed2f2752de473edf3e35904ae4d8cd19c6eb8a0e179bf95ac228bfe1`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	polarion_mcp-3.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.2 MB
Tags	CPython 3.10 Linux glibc 2.17+ x86-64
SHA-256 checksum How to use checksums	`6f4e94a258485edd9a36d75a659b6abccf63963f35fa1f4359ce76d4c715e9be`
BLAKE2b-256 checksum How to use checksums	`7fe2597a7ddd15018cd82d954ae62d23c52ef4a0ed3c1e55643d738d8161cdf0`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	polarion_mcp-3.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	2.2 MB
Tags	CPython 3.10 Linux glibc 2.17+ ARM64
SHA-256 checksum How to use checksums	`6692e2f001abd468a1c2f36d69546a46dc10337e9da49d97ddf1c7ea76b2f817`
BLAKE2b-256 checksum How to use checksums	`f2af7883407d163fecf08fe124669b7e4f93f944176a97b6cb916f0d5696ce84`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / polarion_mcp-3.0.0-cp310-cp310-macosx_11_0_arm64.whl

Download URL	polarion_mcp-3.0.0-cp310-cp310-macosx_11_0_arm64.whl
Size	389.5 kB
Tags	CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`d6d0408fe4b78c747cb39312fec926d56b2b00e856cb71989345ba80bc28e368`
BLAKE2b-256 checksum How to use checksums	`425bc2694d93b118083a042bd3450513afc91dd9415396a0a58937577c0fb567`
Upload date	Feb 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`