Surface selection guide

Use this table to choose the right integration surface.

Surface	Use when	Best for	Status
REST API (/api/v1/*)	Deterministic server workflows	Search, quotes, checkout intent state polling	Stable
MCP general profile (/api/mcp)	Claude/plain/other MCP hosts	Tool calling with structured content	Beta
MCP ChatGPT profile (/api/mcp)	ChatGPT app widgets	Host-aware widget metadata + structured content	Beta
bb CLI	Terminal automation and operator scripts	Search/xref/fit shell flows	Beta (local scaffold)