cortex-docs-mcp

Source repository

MCP server generated from Cortex Docs by Cortex Docs.

Client Setup Guide

Connect your MCP server to an MCP-compatible AI client.

1. What you're connecting

| | | |---|---| | Transport | stdio | | Package | @cortex-docs/mcp | | Command | npx @cortex-docs/mcp | | Runtime | Node.js 20+ | | Auth | none |

2. Prerequisites

• Node.js 20+ and npm on PATH
• No build step needed — npx downloads and runs the package automatically

3. Universal config shape

Most clients use this JSON block. Learn it once:

{
  "mcpServers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

4. Per-client setup

4.1 Claude Code (CLI)

claude mcp add cortex-docs-mcp -- npx @cortex-docs/mcp

Scope with --scope: local (default), project (committed .mcp.json), or user (all projects).

claude mcp list          # see configured servers
claude mcp get cortex-docs-mcp   # inspect one
claude mcp remove cortex-docs-mcp

4.2 Claude Desktop

Edit the config, then fully restart the app:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

4.3 Cursor

Project: .cursor/mcp.json — Global: ~/.cursor/mcp.json

{
  "mcpServers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

4.4 VS Code (GitHub Copilot)

Create .vscode/mcp.json. Note: VS Code uses "servers", not "mcpServers".

{
  "servers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

4.5 OpenAI Codex CLI

Config in ~/.codex/config.toml (TOML format):

[mcp_servers.cortex-docs-mcp]
command = "npx"
args = ["@cortex-docs/mcp"]

4.6 Windsurf

Config: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

4.7 Cline (VS Code extension)

{
  "mcpServers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

4.8 Continue

Create .continue/mcpServers/cortex-docs-mcp.yaml:

name: cortex-docs-mcp
version: 0.0.1
schema: v1
mcpServers:
  - name: cortex-docs-mcp
    command: npx
    args:
      - "@cortex-docs/mcp"

4.9 Zed

In settings.json. Note: Zed uses "context_servers".

{
  "context_servers": {
    "cortex-docs-mcp": {
      "source": "custom",
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

4.10 JetBrains IDEs

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add Server:

{
  "mcpServers": {
    "cortex-docs-mcp": {
      "command": "npx",
      "args": ["@cortex-docs/mcp"]
    }
  }
}

5. Quick reference

| Client | Config location | Key | Format | |--------|----------------|-----|--------| | Claude Code | claude mcp add | — | CLI | | Claude Desktop | ~/Library/.../claude_desktop_config.json | mcpServers | JSON | | Cursor | .cursor/mcp.json | mcpServers | JSON | | VS Code | .vscode/mcp.json | servers | JSON | | Codex CLI | ~/.codex/config.toml | mcp_servers | TOML | | Windsurf | ~/.codeium/windsurf/mcp_config.json | mcpServers | JSON | | Cline | VS Code settings | mcpServers | JSON | | Continue | .continue/mcpServers/cortex-docs-mcp.yaml | mcpServers | YAML | | Zed | settings.json | context_servers | JSON | | JetBrains | AI Assistant settings | mcpServers | JSON |

6. Troubleshooting

• npx not found — Ensure Node.js 18+ is installed and npm is on your PATH
• Command not found in GUI apps — GUI apps may not inherit shell PATH. Use the full path: /usr/local/bin/npx
• Server not responding — Test manually: npx @cortex-docs/mcp
• Permission denied — Try: npx --yes @cortex-docs/mcp

Agent Instructions

Read the project documentation and SDK reference tools before writing integration code. Prefer a generated SDK when one supports the user's language. Use direct API tools when no suitable SDK is available.

Tools

11 tools available for AI agents via cortex-docs-mcp

docs_quickstart

DOCS

Read documentation: Quickstart (Getting Started). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_quickstart",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_configuration

DOCS

Read documentation: Configuration (Getting Started). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_configuration",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_openapi

DOCS

Read documentation: OpenAPI (SDK Generation). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_openapi",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_websocket_sdks

DOCS

Read documentation: WebSocket SDKs (SDK Generation). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_websocket_sdks",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_graphql

DOCS

Read documentation: GraphQL (SDK Generation). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_graphql",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_grpc

DOCS

Read documentation: gRPC (SDK Generation). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_grpc",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_openrpc

DOCS

Read documentation: OpenRPC (SDK Generation). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_openrpc",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_documentation

DOCS

Read documentation: Documentation (Features). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_documentation",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_custom_generators

DOCS

Read documentation: Custom Generators (Features). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_custom_generators",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_mcp_servers

DOCS

Read documentation: MCP Servers (Features). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_mcp_servers",
  "arguments": {}
}

// Returns: full document content (markdown)

docs_publishing

DOCS

Read documentation: Publishing (Features). Returns full markdown content.

// Call this tool to get full content
// The agent receives the complete markdown
// document to use as context.

{
  "name": "docs_publishing",
  "arguments": {}
}

// Returns: full document content (markdown)

Verify

npx @modelcontextprotocol/inspector npx @cortex-docs/mcp