# `MCP010` Get test plan coverage for requirements
{bdg-ref-info}`mcp | tools <mcp:tools>`
{bdg-ref-info}`mcp | query <mcp:query>`
{bdg-ref-info}`mcp | traceability <mcp:traceability>`
> I would like to know which requirements have no tests validating them, so I can
> identify coverage gaps. When preparing for a release or reviewing a specification,
> I need to quickly find what still needs test procedures written for it.
> I also want to distinguish between requirements that have only manual tests
> and those that are fully covered by automated tests.
> 

The user shall be able to retrieve the test plan coverage status of requirements.

The MCP server shall expose a tool named `test_plan_coverage` that partitions
requirements into four groups:

- `no_test_plan`: requirements for which no test references them in its `ref` field
- `manual_test_plan`: requirements that have at least one test, but none of those
  tests have an associated automated code test reference
- `partially_manual_test_plan`: requirements where some but not all associated tests
  have at least one automated code test reference
- `automated_test_plan`: requirements where every associated test has at least one
  automated code test reference (a tagged code reference where the symbol is a test function)

An optional `category` parameter allows filtering by category.

Each group shall be a list of requirement summaries sorted alphabetically by ID,
each containing:
- `id`: The unique identifier
- `short`: The short description (if present)
- `category`: The requirement category
- `tags`: List of tags (if present)


:::{dropdown} Properties
:icon: note
:color: primary

__author__: Claude

__since__: `0.3.1`

__version__: 2

:::
:::{dropdown} Tested by
:open: 
:icon: check-circle-fill
:color: success

- [`TMCP032` test_plan_coverage partitions requirements into coverage buckets](/tests/TMCP032)
- [`TMCP033` test_plan_coverage filtered by category](/tests/TMCP033)
- [`TMCP034` test_plan_coverage filtered to category with no gaps](/tests/TMCP034)
- [`TMCP035` test_plan_coverage errors on unknown category](/tests/TMCP035)
:::

:::{dropdown} References
:icon: link
:color: secondary

__Relates to:__
[`MCP005` Search and filter requirements](/requirements/MCP005)

:::

:::{dropdown} Source
:icon: file-code
:color: info

__Source file__: [`specs/mcp/tracability.yaml`](https://github.com/agagniere/speky/blob/master/specs/mcp/tracability.yaml)

__Loaded from__: [`speky_mcp`](https://github.com/agagniere/speky/blob/master/specs/mcp/mcp.toml)

__Implemented in:__
{fab}`python` [`handle_test_plan_coverage`](https://github.com/agagniere/speky/blob/master/python/speky_mcp/tools.py#L147)
:::