Skip to main content

MCP profiles (general vs ChatGPT)

BearingBrain intentionally supports two MCP profiles at the same endpoint.

General MCP profile​

Use for Claude/plain/non-OpenAI hosts.

  • text-first summaries
  • stable structuredContent
  • no required widget metadata dependency

ChatGPT app profile​

Use for OpenAI app/dev-mode rendering.

  • compact narration text
  • widget metadata under _meta['bearingbrain/widget'] on render tools
  • additive contract metadata under _meta['bearingbrain/contract']

Contract boundary rules​

  • Keep ChatGPT-only behavior additive.
  • Do not remove general-profile structured fields.
  • Preserve backward compatibility for non-ChatGPT consumers.

Validation script (repo local):

npm run mcp:test:profiles