MCP

Connect any MCP client

SageOx speaks the standard MCP protocol with OAuth 2.1 + Dynamic Client Registration (RFC 7591). If your tool supports MCP, this is everything it needs.

Server URL

https://sageox.ai/mcp

mcpServers config

For tools that use a JSON config file:

{
  "mcpServers": {
    "sageox": {
      "url": "https://sageox.ai/mcp"
    }
  }
}

How auth works

On the first call to the SageOx MCP server, your tool will:

  1. Discover OAuth metadata at /.well-known/oauth-authorization-server
  2. Register itself via DCR at /api/auth/oauth2/register (PKCE required)
  3. Open a browser tab to the OAuth consent screen
  4. Exchange the auth code for an access token at /oauth2/token
  5. Use the bearer token for all subsequent MCP calls

This is standard MCP — no SageOx-specific extensions. Any MCP-compliant client should Just Work.

Tools available

ToolWhat it does
ListTeamsLists the teams the authorized user belongs to
ListBubblesLists Knowledge Bubbles the user can see (personal / profile / team / repo / custom)
SaveSessionSaves a chat session into a chosen bubble
SearchSearches the team knowledge index

Tool definitions come from tools/list. Scopes are surfaced on the OAuth consent screen.

Managing connections

/settings/security lists all active grants. Revoke per-client or all at once — revocation invalidates the access token, so the next MCP call returns 401 and the client cleans up its local state.