# Reported issues for zod-contract-mock-forge-mcp

Pod holds 9 of 9 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [zod-contract-mock-forge-mcp](/mcp/zod-contract-mock-forge-mcp).

## Most discussed

### feat: add evaluate_schema_evolution tool

## Problem

When a Zod schema is tightened — new required field added, string narrowed to enum, optional made required — existing static mocks in test fixtures and DB seed files silently become invalid. These only surface as confusing runtime failures deep in the test suite, long after the schema change was merged.

## What the agent gains

Pre-flight breaking change detection that runs before tests. Identifies exactly which mocks are now invalid, the precise field path, and the expected vs rece

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/15) · 2026-05-18 · closed · 0 comments

### feat: add detect_schema_drift tool (Zod vs OpenAPI)

## Problem

Teams maintaining both a Zod schema (runtime validation) and an OpenAPI spec (docs / client generation) inevitably let them diverge. Zod adds a required field — OpenAPI isn't updated. Result:

- AI agents reading docs hallucinate non-existent or incorrect payloads
- Downstream client generation breaks silently
- Integration tests pass locally but fail against the real API

This is called schema drift, and it's invisible until something breaks at runtime.

## What the agent gains

Exp

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/14) · 2026-05-18 · closed · 0 comments

### feat: add generate_mock_variants tool for property-based testing

## Problem

`generate_valid_mock` is deterministic — the same schema always produces the exact same output. This is valuable for snapshot tests, but property-based testing requires diverse valid inputs to surface edge cases that a single static payload misses.

Examples of edge cases only discoverable with varied mocks:
- Empty string passing `.min(1)` check due to off-by-one in custom validator
- Max-length strings triggering DB column overflow
- Random array lengths exposing pagination bugs

#

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/13) · 2026-05-18 · closed · 0 comments

### feat: add generate_exhaustive_union_violations tool

## Problem

`generate_boundary_violations` currently tests only the first or last variant of union/discriminated union schemas. A `z.discriminatedUnion` with 5 branches leaves 3–4 branches completely untested. Common missed violations:

- Missing discriminator key
- Discriminator key with wrong literal value (no branch matches)
- Correct discriminator but type mismatch deep in a specific branch

## What the agent gains

Total branch coverage for polymorphic schemas — every union variant gets tar

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/12) · 2026-05-18 · closed · 0 comments

### Add unit and integration tests for MCP server

Add tests for core logic like 'parseZodSchema' and integration tests for the MCP server using the SDK's testing utilities.

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/5) · 2026-05-16 · closed · 0 comments

### Add more templates (MSW, Jest/Vitest)

Expand 'scaffold_api_contract_test' to support other frameworks and libraries like MSW for mocking and Jest/Vitest for unit tests.

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/4) · 2026-05-16 · closed · 0 comments

### Implement Smart Fixer for schema/data mismatches

Create a tool that takes a Zod validation error and suggests fixes for either the schema or the data payload.

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/3) · 2026-05-16 · closed · 0 comments

### Add read_schema_from_file tool

Add a new MCP tool to read Zod schemas directly from project files instead of requiring copy-pasting code into the chat.

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/2) · 2026-05-16 · closed · 0 comments

## Most recent

### Implement deep mutation for Boundary Violations

Currently, 'generate_boundary_violations' only handles top-level fields. We need to implement recursive mutation for nested objects and arrays, including constraints like .email(), .url(), etc.

[Read the thread](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues/1) · 2026-05-16 · closed · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/vola-trebla/zod-contract-mock-forge-mcp/issues).