Data Contract Validator & Pipeline Guardian — MCP server for AI assistant integration with data pipeline validation, contract management, and incident tracking
Server has 10 tools with basic schemas and descriptions, but significant gaps prevent production use. All tools have descriptions (10-100 chars, mostly adequate), and input schemas are present with type definitions. However, parameter descriptions are sparse or missing entirely, most parameters lack guidance on format, constraints, or valid values. Output schemas are completely undocumented; LLMs cannot predict what fields to expect or chain tools effectively. Error handling is absent from visible code. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels (5 WRITE tools). Naming is verb-first and clear, but parameter naming lacks consistency (e.g., 'pipeline' vs 'pipeline_name'). No evidence of pagination, rate limiting, or result capping for list tools.
Merge an approved fix PR and reload the updated contract.
Open a GitHub PR to update a broken data contract YAML.
Use AI to generate a contract YAML from a live data source.
Get full contract spec, rules, ownership, and version history.
Summary of all pipeline incidents in the last N days including MTTR.
Returns live health status of all registered data pipelines.
Output schemas completely undocumented. LLMs cannot predict response structure, field names, or types. Breaks tool chaining and forces agents to guess at downstream parameter mappings.
Parameter descriptions missing or incomplete. 'pipeline' param in list_quarantine_batches has description, but 'pipeline_name' in get_violation_detail lacks guidance on format/constraints. 'changes' in create_fix_pr is vague ('Description of changes'), should specify format (YAML diff, prose, structured JSON).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
Get schema drift report: contract definition vs live source schema.
Get full violation details for the most recent failure of a pipeline.
List all currently quarantined data batches with full metadata.
Re-validate and replay a quarantined batch after a contract fix is merged.
No tool annotations despite clear risk levels. 5 WRITE tools (create_fix_pr, replay_quarantine, approve_contract_update, generate_contract) lack destructiveHint. All 5 READ tools lack readOnlyHint. Agents cannot distinguish safe from risky operations.
No pagination or result capping for list_quarantine_batches. Tool description does not specify max results, offset/limit params, or total count in response. Large result sets will exhaust context window.
No error handling guidance visible in code. Tools return raw API responses without recovery hints. E.g., if create_fix_pr fails due to GitHub auth, LLM receives no guidance on retry strategy or next steps.