MCP005 Search and filter requirements

mcp | tools mcp | query mcp | discovery

I would like to discover what requirements exist by searching with filters like tags or categories. For example, “show me all requirements tagged with ‘security’” or “what functional requirements exist?” This helps me explore the specification and find related requirements when working on a feature.

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

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

Filter parameters:

• tag: Filter by tag (exact match, e.g., “input” or “output:pdf”). If the tag does not exist in the loaded specifications, an error shall be returned.

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

If no filters are provided, all requirements shall be returned.

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

• id: The unique identifier

• short: The short description (if present)

• category: The requirement category

• tags: List of tags (if present)

The list shall be sorted alphabetically by ID.

Properties

author: Claude

since: 0.2.0

Tested by

• TMCP011 search_requirements returns all when unfiltered

• TMCP012 search_requirements filtered by tag

• TMCP013 search_requirements filtered by namespaced tag

• TMCP014 search_requirements filtered by category

• TMCP015 search_requirements errors on unknown tag

• TMCP031 search_requirements errors on unknown category

References

Referenced by:

• MCP010 Get test plan coverage for requirements

• MCP011 Search and filter tests

Source

Source file: specs/mcp/discovery.yaml

Loaded from: speky_mcp

Implemented in: handle_search_requirements