MCP011 Search and filter tests

mcp | tools mcp | query mcp | discovery mcp | traceability

I would like to discover what tests exist by searching with filters like category or the requirement they validate. For example, “show me all non-functional tests” or “which functional tests validate RF03” helps me explore the test suite and prepare targeted test campaigns.

The user shall be able to search for tests using optional filter criteria.

The MCP server shall expose a tool named search_tests that accepts optional filter parameters and returns matching tests.

Filter parameters:

• category: Filter by category (exact match, e.g., “functional”). If the category does not exist in the loaded specifications, an error shall be returned.

• tester_of: Filter by requirement ID — returns only tests that reference that requirement in their ref field. If the requirement ID does not exist, an error shall be returned.

If no filters are provided, all tests shall be returned. Filters can be combined.

The response shall be a list of test summaries, each containing:

• id: The unique identifier

• short: The short description (if present)

• category: The test category

The list shall be sorted alphabetically by ID.

Properties

author: Claude

since: 0.2.0

Tested by

• TMCP036 search_tests returns all tests when unfiltered

• TMCP037 search_tests filtered by category

• TMCP038 search_tests filtered by tester_of

• TMCP039 search_tests filtered by category and tester_of

• TMCP040 search_tests returns empty list when tester_of has no tests

• TMCP041 search_tests errors on unknown category

• TMCP042 search_tests errors on unknown tester_of

References

Relates to: MCP005 Search and filter requirements

Source

Source file: specs/mcp/discovery.yaml

Loaded from: speky_mcp

Implemented in: handle_search_tests