oas2mcp.classify.operations

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.

Examples

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

Functions

classify_catalog(→ oas2mcp.models.mcp.McpBundle)	Classify all operations in a catalog.
classify_operation(→ oas2mcp.models.mcp.McpCandidate)	Classify one operation into a first-pass MCP candidate.

Module Contents

oas2mcp.classify.operations.classify_catalog(catalog: oas2mcp.models.normalized.ApiCatalog) → oas2mcp.models.mcp.McpBundle

Classify all operations in a catalog.

Parameters:

catalog – The normalized API catalog.

Returns:

An McpBundle containing first-pass candidates.

Raises:

None. –

Examples

bundle = classify_catalog(catalog)

oas2mcp.classify.operations.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.

Parameters:

• catalog – The normalized API catalog.

• operation – The normalized API operation.

Returns:

A first-pass McpCandidate.

Raises:

None. –

Examples

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