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

Project links

Data verified by PyPI on Jul 17, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for inflectra from gravatar.com inflectra

Credits

Author: Inflectra Corporation

GitHub Statistics

Data verified by PyPI on Jul 17, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Tags

MCP AI GenAI

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_spira-2.0.0.tar.gz (134.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_spira-2.0.0-py3-none-any.whl (183.4 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_spira-2.0.0.tar.gz.

File metadata

  • Download URL: mcp_server_spira-2.0.0.tar.gz
  • Upload date:
  • Size: 134.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for mcp_server_spira-2.0.0.tar.gz
Algorithm Hash digest
SHA256 b4118400c01a851110bce24f2dd4ccd7f730b310cf358a551b9f56a4e6b1814a
MD5 994f9217ed60320002252eb0affff28a
BLAKE2b-256 34378e34003012f2332a2975d3d54c28b86db47b8558af6ffac89768c8630373

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_server_spira-2.0.0.tar.gz:

Publisher: publish.yml on Inflectra/mcp-server-spira

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_server_spira-2.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_spira-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7f75b99e358a20695945d46c32517ff30174572d8abfc4c0390d7fd73d8f4de7
MD5 95b12f9cf765aef7853177e82cd030a1
BLAKE2b-256 12b511acfd9063ac43b5bf120375d1f286ca9bd04bbd1f2321d2c6a5b3556526

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_server_spira-2.0.0-py3-none-any.whl:

Publisher: publish.yml on Inflectra/mcp-server-spira

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 files

1.1.1

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page