{"product":"BearingBrain External API","version":"v1","generatedAt":"2026-05-21T08:18:10.049Z","docs":{"openapi":"https://bearingbrain.com/.well-known/openapi.json","facts":"https://bearingbrain.com/facts","capabilities":"https://bearingbrain.com/capabilities","llms":"https://bearingbrain.com/llms.txt","toleranceRings":"https://bearingbrain.com/tolerance-rings","seals":"https://bearingbrain.com/seals","lubrication":"https://bearingbrain.com/lubrication","maintenance":"https://bearingbrain.com/maintenance"},"auth":{"readEndpoints":"public","writeEndpoints":"api_key","apiKeyHeader":"x-api-key","bearerAuth":{"status":"oauth_ready_scaffold","protectedResourceMetadata":"https://bearingbrain.com/.well-known/oauth-protected-resource","authorizationServerMetadata":"https://bearingbrain.com/.well-known/oauth-authorization-server","introspectionEndpoint":"https://bearingbrain.com/api/v1/oauth/introspect"},"mcpAuthModeEnv":"BEARINGBRAIN_MCP_AUTH_MODE (none|required)"},"endpoints":{"search":"/api/v1/search?q=<query>&limit=10","stats":"/api/v1/stats","feedsHealth":"/api/v1/feeds/health","quoteCreate":"/api/v1/quotes","quoteStatus":"/api/v1/quotes/{quoteId}","checkoutIntentCreate":"/api/v1/agentic/checkout-intents","checkoutIntentStatus":"/api/v1/agentic/checkout-intents/{intentId}","oauthIntrospect":"/api/v1/oauth/introspect","oauthProtectedResourceMetadata":"/.well-known/oauth-protected-resource","oauthAuthorizationServerMetadata":"/.well-known/oauth-authorization-server","toleranceRings":"/api/tolerance-rings"},"agentToolContracts":{"readOnly":["search_catalog","fitment_sanity_check","compare_quote_or_bom","identify_from_evidence","tolerance_ring_lookup"],"writeScopedApi":["quoteCreate","checkoutIntentCreate"]},"notes":["BearingBrain is an engineering-assistant platform, not a cross-reference-only tool.","Tolerance ring support is live: direct intent handling + context-gated suggestions for fit/retention/creep scenarios.","Reliability stack lanes are active now across seals, lubrication, and maintenance workflows.","quotes endpoint supports API-key scoped RFQ submission and idempotent replay for agent workflows.","checkout-intents supports Stripe card checkout creation with API key + idempotency and webhook-confirmed payment state.","For real-time tool use, prefer MCP at /api/mcp with host-mediated consent.","MCP auth can be enforced with BEARINGBRAIN_MCP_AUTH_MODE=required using API key or OAuth bearer scopes (mcp.read/mcp.write)."]}