@atoms-tech/polarion-mcp

Connect any AI IDE to Siemens Polarion ALM in under 2 minutes.

Prerequisites

1. Node.js ≥ 18 — Download
2. ATOMS API Key — Get one free at portal.atoms.tech

Installation

Claude Code

claude mcp add polarion-mcp \
  --env ATOMS_API_KEY=atoms-sk-xxxx \
  -- npx @atoms-tech/polarion-mcp@latest

Cursor / VS Code / Windsurf

Add to your MCP settings file (.cursor/mcp.json, .vscode/mcp.json, etc.):

{
  "mcpServers": {
    "polarion-mcp": {
      "command": "npx",
      "args": ["@atoms-tech/polarion-mcp@latest"],
      "env": {
        "ATOMS_API_KEY": "atoms-sk-xxxx"
      }
    }
  }
}

Other IDEs

Add to your MCP configuration:

{
  "mcpServers": {
    "polarion-mcp": {
      "command": "npx",
      "args": ["@atoms-tech/polarion-mcp@latest"],
      "env": {
        "ATOMS_API_KEY": "atoms-sk-xxxx"
      }
    }
  }
}

How It Works

1. You register at portal.atoms.tech and enter your Polarion URL + Personal Access Token (PAT). These are stored securely server-side — never on your machine.
2. You get an ATOMS API Key (atoms-sk-xxxx) — the only thing you put in your IDE config.
3. This package starts a lightweight local MCP bridge and forwards requests to https://mcp.polarion.atoms.tech/mcp.
4. The hosted ATOMS service validates your key, retrieves your Polarion credentials server-side, and executes the Polarion API call on your behalf.
5. One credit is deducted per successful tool call. Failed calls cost nothing.

Available Tools

| Tool | Description | |------|-------------| | check_connection | Verify your Polarion connection is working | | list_projects | List all accessible Polarion projects | | get_project | Get details about a specific project | | search_workitems | Search work items with Lucene queries | | get_workitem | Get a work item by ID | | get_workitem_details | Get full work item details including custom fields | | get_workitem_history | Get work item revision history | | list_workitem_types | List available work item types | | list_custom_fields | List custom fields for a work item type | | list_spaces | List document spaces in a project | | list_documents | List documents in a space | | get_document_info | Get document metadata | | get_document_outline | Get document structure | | get_document_section | Get a specific section | | search_in_document | Search within a document | | get_workitems_in_module | Get work items in a module/document |

Try It

After installation, prompt your AI assistant:

Help me explore my Polarion project with check_connection.

Plans & Credits

| Plan | Credits/month | Price | |------|--------------|-------| | Free | 150 | $0 | | Starter | 1,500 | $19/mo | | Standard | 6,000 | $69/mo | | Enterprise | Unlimited | Custom |

Manage credits and billing at portal.atoms.tech.

Support

• Docs: docs.atoms.tech/polarion-mcp
• Issues: github.com/atoms-tech/polarion-mcp-server/issues
• Email: [email protected]