Proxy

The ag2 proxy command wraps existing interfaces as AG2-compatible tools.

CLI Wrapping#

Generate typed Python wrappers for CLI commands:

ag2 proxy --command kubectl --subcommands "get pods,logs,describe"

The CLI introspects --help output to extract flags, arguments, and descriptions, then generates @tool-decorated functions that call the CLI via subprocess.

OpenAPI Wrapping#

Generate tools from an OpenAPI/Swagger specification:

ag2 proxy --openapi https://api.example.com/openapi.json

This parses the spec and generates one tool per endpoint with proper type hints, authentication handling via environment variables, and error handling.

Python Module Wrapping#

Wrap functions from a Python module:

ag2 proxy --module pandas --functions "read_csv,describe"

This introspects function signatures and generates tool wrappers with proper typing.

MCP Serving#

Instead of generating Python files, serve the wrapped tools as an MCP server:

ag2 proxy --command git --subcommands "status,log,diff" --serve-mcp

Options#