MCP server for the NSIP Search API, providing livestock animal search, analytics, flock management, and breed information tools
13 tools with complete schemas and descriptions. Naming follows verb_noun pattern (search, get, rank, compare). Descriptions are adequate (50-150 chars typical) but lack LLM-optimized guidance on WHEN to use each tool vs. similar ones. Parameters are typed and described, but many lack constraints (enums, ranges). Output schemas are not documented, LLMs cannot predict response structure. Error handling is absent from tool definitions. No tool annotations (readOnlyHint, idempotentHint). Composition is sound: tools chain logically (search → details → lineage/progeny → profile). All tools are read-only, reducing risk.
List all available breed groups in the NSIP database
Compare two or more animals side-by-side with optional trait filtering
Get the current status of the NSIP database
Get detailed information about a specific animal by LPN ID or registration number
Get a summary of animals in a specific flock
Check inbreeding coefficient between a sire and dam
Get lineage (ancestry) information for a specific animal
Output schemas not documented. LLMs cannot predict response structure (fields, types, nested objects). Forces agents to guess what data is available after each call.
Parameter constraints missing. 'page_size' accepts 1-100 but no enum/min/max in schema. 'status' accepts CURRENT|SOLD|DEAD but no enum. 'gender' accepts Male|Female|Both but no enum. Free-form strings invite hallucinated values.
Descriptions lack WHEN-to-use guidance. 'Get detailed information' is generic; should say 'Use after search() to fetch full record for a specific animal.' Ambiguous when to call details vs profile vs lineage.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | <=2025-11-25 | v2 |
Get mating recommendations for an animal to optimize offspring traits
Get full profile (details + lineage + progeny) for an animal
Get progeny (offspring) information for a specific animal
Rank animals by weighted trait scores within a breed
Search for animals in the NSIP database with filters for breed, gender, status, date range, flock, and sorting
Get trait ranges and statistics for a specific breed
No tool annotations. All tools are read-only but lack readOnlyHint annotation. Agents cannot distinguish safe tools from destructive ones without explicit hints.
Error handling absent from tool definitions. No guidance on retryable vs user-fixable errors. E.g., 'LPN not found' should suggest search_animals() first.