oas2mcp.classify.operations
===========================

.. py:module:: oas2mcp.classify.operations

.. autoapi-nested-parse::

   Deterministic operation classification helpers.

   Purpose:
       Convert normalized API operations into first-pass MCP candidates before any
       agent enhancement step.

   Design:
       - Classify each operation using stable heuristics.
       - Prefer predictable defaults over aggressive inference.
       - Attach prompt suggestions so later agents can elaborate rather than
         invent structure from scratch.

   .. rubric:: Examples

   .. code-block:: python

       bundle = classify_catalog(catalog)
       candidate = bundle.candidates[0]



Functions
---------

.. autoapisummary::

   oas2mcp.classify.operations.classify_catalog
   oas2mcp.classify.operations.classify_operation


Module Contents
---------------

.. py:function:: classify_catalog(catalog: oas2mcp.models.normalized.ApiCatalog) -> oas2mcp.models.mcp.McpBundle

   Classify all operations in a catalog.

   :param catalog: The normalized API catalog.

   :returns: An ``McpBundle`` containing first-pass candidates.

   :raises None.:

   .. rubric:: Examples

   .. code-block:: python

       bundle = classify_catalog(catalog)


.. py:function:: classify_operation(*, catalog: oas2mcp.models.normalized.ApiCatalog, operation: oas2mcp.models.normalized.ApiOperation) -> oas2mcp.models.mcp.McpCandidate

   Classify one operation into a first-pass MCP candidate.

   :param catalog: The normalized API catalog.
   :param operation: The normalized API operation.

   :returns: A first-pass ``McpCandidate``.

   :raises None.:

   .. rubric:: Examples

   .. code-block:: python

       candidate = classify_operation(
           catalog=catalog,
           operation=operation,
       )