llm-cli-gateway API reference

llm-cli-gateway exposes the Model Context Protocol over local stdio by default and over Streamable HTTP at /mcp when the operator starts llm-cli-gateway --transport=http.

Machine-readable API files

• OpenAPI 3.1 description
• RFC 9727-style API catalog
• MCP server card
• Runtime-derived MCP tool index

Authentication

HTTP transport supports static bearer tokens and built-in OAuth 2.0 with PKCE. OAuth scopes include mcp:read, mcp:call, workspace:read, workspace:admin, approval:read, and provider:admin.

JSON errors

HTTP API errors are JSON objects with error, code, and message fields. MCP tool errors are returned through normal JSON-RPC error or tool result envelopes.

Endpoints

• POST /mcp - MCP JSON-RPC and Streamable HTTP transport.
• GET /healthz - unauthenticated readiness and bounded process-health summary.