{
  "markdown": "# MCP Inflectra Spira Server\n\nA Model Context Protocol (MCP) server that lets AI assistants interact with [Inflectra Spira](https://www.inflectra.com/SpiraPlan/) — covering project management, test management, and requirements management.\n\nWorks with SpiraTest, SpiraTeam, and SpiraPlan.\n\n---\n\n## Table of Contents\n\n- [Quick Start](#quick-start)\n- [Configuration](#configuration)\n- [Available Tools](#available-tools)\n- [Usage Examples](#usage-examples)\n- [License](#license)\n\n---\n\n## Quick Start\n\nInstall from PyPI:\n\n```bash\npip install mcp-server-spira\n```\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"inflectra-spira\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"mcp_server_spira\"],\n      \"env\": {\n        \"INFLECTRA_SPIRA_BASE_URL\": \"https://myinstance.spiraservice.net\",\n        \"INFLECTRA_SPIRA_USERNAME\": \"mylogin\",\n        \"INFLECTRA_SPIRA_API_KEY\": \"{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX}\"\n      }\n    }\n  }\n}\n```\n\nFor Cline, add `\"type\": \"stdio\"` to the server config. For Claude Desktop:\n\n```bash\nmcp install src/mcp_server_spira/server.py --name \"Inflectra Spira Server\"\n```\n\n---\n\n## Configuration\n\nSet these environment variables (or use a `.env` file):\n\n| Variable | Required | Description |\n|---|---|---|\n| `INFLECTRA_SPIRA_BASE_URL` | Yes | Base URL for your Spira instance |\n| `INFLECTRA_SPIRA_USERNAME` | Yes | Your Spira login name |\n| `INFLECTRA_SPIRA_API_KEY` | Yes | API Key (RSS Token) from your Spira user profile |\n| `SPIRA_PROJECT_ID` | No | Default product ID — avoids passing `product_id` on every call |\n\n---\n\n## Available Tools\n\n13 tools organized by scope. All data-retrieval tools return structured JSON\nwith field projection, filtering, and a consistent response envelope.\n\n### Search Tools\n| Tool | Description |\n|---|---|\n| `mywork_search_artifacts` | Your assigned items (task, incident, requirement, test_case, test_set) with filtering and field projection |\n| `product_search_artifacts` | Search artifacts in a product (11 types). Supports cross-product fan-out, server-side filtering, and nested sub-artifact includes. |\n| `product_get_artifact` | Single artifact by ID with full details and optional sub-artifact includes |\n| `program_search_artifacts` | Search program-level artifacts (capability, milestone) |\n\n### Write Tools\n| Tool | Description |\n|---|---|\n| `product_create_artifact` | Create artifacts (incident, task, requirement, test_case, risk, release, test_set, build, test_step, mitigation, requirement_step) |\n| `product_update_artifact` | Update existing artifacts |\n| `product_record_test_run` | Record automated test results from CI/CD |\n| `create_comment` | Add a comment to an artifact |\n| `create_association` | Link two artifacts (related-to, depends-on, coverage) |\n\n### Workspace & Configuration Tools\n| Tool | Description |\n|---|---|\n| `workspace_search` | List products, programs, or product templates with field projection |\n| `workspace_get` | Get a single product, program, or template by ID |\n| `template_get_metadata` | Types, statuses, priorities, severities, custom properties, and more for a template |\n| `get_artifact_schema` | Field schema for any artifact type (local-only, no API call) |\n\n---\n\n## Usage Examples\n\nTry these prompts with your AI assistant:\n\n```\nShow me my assigned tasks in Spira\n```\n\n```\nList all products in my Spira instance\n```\n\n```\nGet the open incidents in product 55\n```\n\n```\nSearch for critical requirements across products 55 and 60\n```\n\n```\nGet the field schema for incidents\n```\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nBuilt with [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) · [Spira REST API v7.0](https://spiradoc.inflectra.com/Developers/API-Overview/)\n\n<!-- mcp-name: io.github.Inflectra/mcp-server-spira -->\n",
  "bytes": 3776,
  "sha": "500f321ac41462298d2ec02a11af71dd5cd02f2095fe9203f82e311caa49b5d6",
  "repo_slug": "inflectra/mcp-server-spira",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_inflectra_mcp_server_spira_e1ca124b/readme"
}