Skip to main content

OpenAI Compatibility

FAOS exposes an OpenAI-compatible adapter for MCP tools through the faos_api.openai_compat bounded context. The adapter reads the canonical MCP manifest, emits OpenAI function tool definitions, and routes tool_call invocations back through the FAOS MCP gateway ACL.

Use /v1/tools to inspect generated function tools and /v1/tool_calls for local conformance invocation tests. Production mounting keeps the OpenAI wire prefix as /v1 so OpenAI SDK clients can use FAOS as a base URL without a path rewrite.

The tenant contract is strict: callers authenticate with a valid OIDC bearer token, and the adapter derives tenant_id from validated JWT claims only. A client-supplied tenant_id in headers, query parameters, or request bodies is never used to set tenant context.

See Assistants tool calls for streaming and parallel tool_call behavior.