io.github.wellknownmcp/cortex-gateway MCP Server

Name: io.github.wellknownmcp/cortex-gateway MCP Server
Author: io.github.wellknownmcp

io.github.wellknownmcp/cortex-gateway

Repository Registry

What is the io.github.wellknownmcp/cortex-gateway MCP server?

Self-hosted federated MCP gateway: one OAuth 2.1 MCP server in front of N apps, user-level scopes.

How to install io.github.wellknownmcp/cortex-gateway

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CORTEX_CANONICAL_URI
required
Canonical MCP resource URI (RFC 9728)
OAUTH_ISSUER
required
OAuth 2.1 authorization server URL
CORTEX_BACKENDS
required
Comma-separated federated backend ids
CORTEX_TECHNICAL_TOKEN
required
secret
Static token for backend catalog discovery

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cortex-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wellknownmcp/cortex-gateway:v0.2.0"
      ],
      "env": {
        "CORTEX_CANONICAL_URI": "<YOUR_CORTEX_CANONICAL_URI>",
        "OAUTH_ISSUER": "<YOUR_OAUTH_ISSUER>",
        "CORTEX_BACKENDS": "<YOUR_CORTEX_BACKENDS>",
        "CORTEX_TECHNICAL_TOKEN": "<YOUR_CORTEX_TECHNICAL_TOKEN>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "cortex-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wellknownmcp/cortex-gateway:v0.2.0"
      ],
      "env": {
        "CORTEX_CANONICAL_URI": "<YOUR_CORTEX_CANONICAL_URI>",
        "OAUTH_ISSUER": "<YOUR_OAUTH_ISSUER>",
        "CORTEX_BACKENDS": "<YOUR_CORTEX_BACKENDS>",
        "CORTEX_TECHNICAL_TOKEN": "<YOUR_CORTEX_TECHNICAL_TOKEN>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cortex-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wellknownmcp/cortex-gateway:v0.2.0"
      ],
      "env": {
        "CORTEX_CANONICAL_URI": "<YOUR_CORTEX_CANONICAL_URI>",
        "OAUTH_ISSUER": "<YOUR_OAUTH_ISSUER>",
        "CORTEX_BACKENDS": "<YOUR_CORTEX_BACKENDS>",
        "CORTEX_TECHNICAL_TOKEN": "<YOUR_CORTEX_TECHNICAL_TOKEN>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "cortex-gateway": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wellknownmcp/cortex-gateway:v0.2.0"
      ],
      "env": {
        "CORTEX_CANONICAL_URI": "<YOUR_CORTEX_CANONICAL_URI>",
        "OAUTH_ISSUER": "<YOUR_OAUTH_ISSUER>",
        "CORTEX_BACKENDS": "<YOUR_CORTEX_BACKENDS>",
        "CORTEX_TECHNICAL_TOKEN": "<YOUR_CORTEX_TECHNICAL_TOKEN>"
      }
    }
  }
}

Claude Code

claude mcp add cortex-gateway --env CORTEX_CANONICAL_URI=<YOUR_CORTEX_CANONICAL_URI> --env OAUTH_ISSUER=<YOUR_OAUTH_ISSUER> --env CORTEX_BACKENDS=<YOUR_CORTEX_BACKENDS> --env CORTEX_TECHNICAL_TOKEN=<YOUR_CORTEX_TECHNICAL_TOKEN> -- docker run -i --rm ghcr.io/wellknownmcp/cortex-gateway:v0.2.0

Related MCP servers

Hoshin Kanri X-Matrix

Active

Strategic memory agents can build, score and keep current: a living X-Matrix with review cadences.

JavaScript

MIT

View repository →

Animam Agent Platform

Configure & analyze AI chatbots: personas, corpus, tools, digests, multi-bot. OAuth 2.1.

View repository →

IA-Asso.fr — French Associations Registry

Search 1.26M+ active French associations (official RNA registry, 10 tools, premium & RUP filters)

View repository →