OpenAPI specification
OpenAPI 3.1.1 description of the MCP transport, OAuth discovery endpoints, typed requests, responses, and errors.
BriefHQ developer resources for AI agents: OpenAPI specification, Streamable HTTP MCP server, OAuth discovery, setup docs, and machine-readable manifests.
Discover the API surface, connect through Streamable HTTP MCP, and authenticate with OAuth. No API key or sales call required.
Machine-readable
OpenAPI 3.1.1 description of the MCP transport, OAuth discovery endpoints, typed requests, responses, and errors.
Official MCP Registry server.json format with Brief's canonical Streamable HTTP endpoint.
When to use Brief, how an agent should call it, and links to product and integration documentation.
Schema-versioned discovery for the Brief CLI skill, including a content digest.
Canonical connection
Configure an MCP-compatible host with this URL:
https://app.briefhq.ai/mcp
Brief uses OAuth 2.1-style authorization with PKCE and dynamic client registration. Compatible hosts open sign-in on the first tool call, so there is no API key to create, copy, or rotate.
After connecting, call brief_get_onboarding_context at the start of a product task. Use brief_search for product facts and decision history, and brief_ask for judgment or trade-offs.
Create a self-serve account on the Free plan, which includes a monthly usage allowance and requires no credit card. Brief does not currently publish a separate sandbox environment.
Host-specific instructions are available for Cursor, Claude Code, VS Code, Claude Desktop, Codex, ChatGPT, Windsurf, and other MCP clients.