list_models
Discover exported Pydantic models in configured Python packages. Use this tool to find available models for validation, schema generation, or migration analysis.
Instructions
Discover exported Pydantic models in configured packages.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| packages | No | ||
| filter | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | ||
| artifacts | No | ||
| diagnostics | No | ||
| resolved_target | No |
Implementation Reference
- src/pydantic_mcp/tools.py:58-77 (handler)The implementation of the `list_models` tool, which discovers Pydantic models in specified packages and returns them as a `ToolResponse`.
@mcp.tool(tags={"discovery", "pydantic"}) def list_models( packages: list[str] | None = None, filter: str | None = None, ) -> ToolResponse: """Discover exported Pydantic models in configured packages.""" package_list = packages or SERVER_SETTINGS.default_scan_packages entries = REGISTRY.discover(package_list) models = registry_entries_to_summaries(entries, pattern=filter) return make_response( diagnostics=[ Diagnostic( level="info", message=f"Discovered {len(models)} model(s).", code="model_discovery", ) ], artifacts={"packages": package_list}, result={"models": [model.model_dump(mode="json") for model in models]}, )