MCP003 Get requirement by ID

mcp | tools mcp | query

I would like to retrieve the full details of a specific requirement when I only know its ID. This will help me understand what a requirement is about before suggesting modifications or writing related tests.

The user shall be able to query a requirement by its unique identifier.

The MCP server shall expose a tool named get_requirement that accepts a requirement ID as a string parameter and returns the full requirement details.

The response shall include all available fields:

• id: The unique identifier

• category: The category this requirement is from

• long: The full description

• source_file: Path to the specification file this requirement was loaded from

• short: The short description (if present)

• tags: List of tags (if present)

• properties: Key-value properties (if present)

• client_statement: Client’s original statement (if present)

• ref: List of referenced requirement IDs (if present)

• tested_by: List of test IDs that validate this requirement

• referenced_by: List of requirement IDs that reference this requirement

• comments: List of comments about this requirement

• code_references: List of code locations tagged with this requirement ID (if any), each with file, line, and symbol (or null for free references)

If the requirement ID does not exist, the tool shall return an error message.

Properties

author: Claude

since: 0.2.0

Tested by

• TMCP004 get_requirement with minimal fields

• TMCP005 get_requirement with all fields

• TMCP006 get_requirement errors on unknown ID

• TMCP016 get_requirement errors on non-requirement ID

• TMCP043 get_requirement includes code references

References

Referenced by: MCP007 List requirements referencing another

Source

Source file: specs/mcp/query.yaml

Loaded from: speky_mcp

Implemented in: handle_get_requirement