pydantic-mcp

Instructions

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]},
      )