MCP Inflectra Spira Server
A Model Context Protocol (MCP) server that lets AI assistants interact with Inflectra Spira — covering project management, test management, and requirements management.
Works with SpiraTest, SpiraTeam, and SpiraPlan.
Table of Contents
Quick Start
Install from PyPI:
pip install mcp-server-spira
Add to your MCP client config:
{
"mcpServers": {
"inflectra-spira": {
"command": "python",
"args": ["-m", "mcp_server_spira"],
"env": {
"INFLECTRA_SPIRA_BASE_URL": "https://myinstance.spiraservice.net",
"INFLECTRA_SPIRA_USERNAME": "mylogin",
"INFLECTRA_SPIRA_API_KEY": "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX}"
}
}
}
}
For Cline, add "type": "stdio" to the server config. For Claude Desktop:
mcp install src/mcp_server_spira/server.py --name "Inflectra Spira Server"
Configuration
Set these environment variables (or use a .env file):
| Variable | Required | Description |
|---|---|---|
INFLECTRA_SPIRA_BASE_URL |
Yes | Base URL for your Spira instance |
INFLECTRA_SPIRA_USERNAME |
Yes | Your Spira login name |
INFLECTRA_SPIRA_API_KEY |
Yes | API Key (RSS Token) from your Spira user profile |
SPIRA_PROJECT_ID |
No | Default product ID — avoids passing product_id on every call |
Available Tools
13 tools organized by scope. All data-retrieval tools return structured JSON with field projection, filtering, and a consistent response envelope.
Search Tools
| Tool | Description |
|---|---|
mywork_search_artifacts |
Your assigned items (task, incident, requirement, test_case, test_set) with filtering and field projection |
product_search_artifacts |
Search artifacts in a product (11 types). Supports cross-product fan-out, server-side filtering, and nested sub-artifact includes. |
product_get_artifact |
Single artifact by ID with full details and optional sub-artifact includes |
program_search_artifacts |
Search program-level artifacts (capability, milestone) |
Write Tools
| Tool | Description |
|---|---|
product_create_artifact |
Create artifacts (incident, task, requirement, test_case, risk, release, test_set, build, test_step, mitigation, requirement_step) |
product_update_artifact |
Update existing artifacts |
product_record_test_run |
Record automated test results from CI/CD |
create_comment |
Add a comment to an artifact |
create_association |
Link two artifacts (related-to, depends-on, coverage) |
Workspace & Configuration Tools
| Tool | Description |
|---|---|
workspace_search |
List products, programs, or product templates with field projection |
workspace_get |
Get a single product, program, or template by ID |
template_get_metadata |
Types, statuses, priorities, severities, custom properties, and more for a template |
get_artifact_schema |
Field schema for any artifact type (local-only, no API call) |
Usage Examples
Try these prompts with your AI assistant:
Show me my assigned tasks in Spira
List all products in my Spira instance
Get the open incidents in product 55
Search for critical requirements across products 55 and 60
Get the field schema for incidents
License
MIT — see LICENSE.
Built with MCP Python SDK · Spira REST API v7.0
Metadata
Release files for mcp-server-spira 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_server_spira-2.0.0.tar.gz | 134.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_server_spira-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 317.6 kB
Release files / mcp_server_spira-2.0.0.tar.gz
| Download URL | mcp_server_spira-2.0.0.tar.gz |
|---|---|
| Size | 134.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b4118400c01a851110bce24f2dd4ccd7f730b310cf358a551b9f56a4e6b1814a
|
|
BLAKE2b-256 checksum How to use checksums |
34378e34003012f2332a2975d3d54c28b86db47b8558af6ffac89768c8630373
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 17, 2026.
Transparency logRelease files / mcp_server_spira-2.0.0-py3-none-any.whl
| Download URL | mcp_server_spira-2.0.0-py3-none-any.whl |
|---|---|
| Size | 183.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7f75b99e358a20695945d46c32517ff30174572d8abfc4c0390d7fd73d8f4de7
|
|
BLAKE2b-256 checksum How to use checksums |
12b511acfd9063ac43b5bf120375d1f286ca9bd04bbd1f2321d2c6a5b3556526
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 17, 2026.
Transparency log