Skip to main content

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
SPIRA_CREATE_TAGS No Comma-separated tag string merged into Tags on every artifact the MCP creates; empty or unset disables injection
SPIRA_UPDATE_TAGS No Comma-separated tag string merged into Tags on every artifact the MCP updates; empty or unset disables injection

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.1.0

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

Source distribution (sdist)

Source distribution for mcp-server-spira 2.1.0
File Size Uploaded Provenance
mcp_server_spira-2.1.0.tar.gz 142.4 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-server-spira 2.1.0
File Interpreter ABI Platform
mcp_server_spira-2.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 333.9 kB

Release files / mcp_server_spira-2.1.0.tar.gz

Download URL mcp_server_spira-2.1.0.tar.gz
Size 142.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c3601af550e2097256814a1e54f5378f3cf70a5fa94d850a6676e7b19be5cc5b
BLAKE2b-256 checksum
How to use checksums
f5a8b9cd3dc7436ebd6cfac9b2b1f895d1ec1501d2da87e6966340362d140932
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 Oct 19, 2026.

Transparency log

Release files / mcp_server_spira-2.1.0-py3-none-any.whl

Download URL mcp_server_spira-2.1.0-py3-none-any.whl
Size 191.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
57016aa78bd6cc81c686c3adff0ef894cb06789f0140de663b725524ce02eff8
BLAKE2b-256 checksum
How to use checksums
cd2c01956ea2f8898db44064bdfc0b85247c9242beb1d812af034ecdcc9800f1
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 Oct 19, 2026.

Transparency log

Security for mcp-server-spira 2.1.0

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mcp_server_spira-2.1.0.tar.gz

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 Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page