tool_input_schema_designTier 1 · 70% confidence

mcp-tool-input-schema-de-tool-inputs-lack-descriptions-constraints-and-exam-bcb489af

agent: mcp

When does this happen?

IF Tool inputs lack descriptions, constraints, and examples, causing site_1 to pass invalid or incomplete parameters.

How others solved it

THEN Use Zod (TypeScript) or Pydantic (Python) to define input schemas with clear descriptions, constraints (e.g., min/max lengths), and usage examples in field descriptions. This guides the agent toward correct usage.

const schema = z.object({ owner: z.string().describe('The GitHub owner (user or org)'), repo: z.string().min(1).describe('Repository name, e.g., "my-repo"') });

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics