---
title: "Cortex MCP reference"
canonical: https://workspace.socra.com/docs/cortex/reference/mcp
---

# Cortex MCP reference

Cortex exposes one hosted remote HTTP MCP server for knowledge and coordinated work.

## Endpoint

Use this canonical server URL:

```text
https://cortex.socra.cloud/mcp
```

The server does not require a local process or a local MCP passthrough.

## Discovery

An unauthenticated request receives a `401` Bearer challenge with a `resource_metadata` URL. The canonical protected-resource metadata is available at:

```text
https://cortex.socra.cloud/.well-known/oauth-protected-resource/mcp
```

The metadata identifies `https://oauth.socra.cloud` as the authorization server. OAuth discovery directs browser authorization to `https://account.socra.com/oauth/authorize` and token requests to `https://oauth.socra.cloud/oauth/token`.

## Authorization

The [first-party coding-agent plugins](/docs/cortex/integrations/coding-agents) use pre-registered public clients and Authorization Code with PKCE. Custom applications register an OAuth client through a customer-owned Cloud Project.

Cortex accepts the standard account-scoped Socra access token. Review [access and permissions](/docs/cortex/administration/access-and-permissions) before choosing the principal and Account for the connection. Cortex does not require a separate Cortex-only audience token.

## Tool families

The MCP server presents tools from these Cortex areas:

- `context_*` tools inspect the [knowledge map](/docs/cortex/concepts/modules-and-map) and [flash Modules](/docs/cortex/concepts/flashing-context).
- `issue_*` tools [inspect and coordinate work](/docs/cortex/concepts/issues-and-coordination), including reading the [Cortex inbox](/docs/cortex/concepts/inbox#use-the-inbox-from-another-interface) through `issue_inbox`.
- `label_*` tools manage reusable [Issue labels](/docs/cortex/guides/issue-labels).
- `comment_*` tools read and author [Issue discussion](/docs/cortex/concepts/issues-and-coordination#comments).
- `issue_attachment_*` and `comment_attachment_*` tools manage [Issue attachments](/docs/cortex/guides/issue-attachments) and their comment placements.

The discovered tool schema is the current interface reference. Review it in the host before allowing writes or deletes, and review the [Cortex security model](/docs/cortex/administration/security) before changing the host's approval policy.

## Custom configuration

Follow [Configure the Cortex MCP server](/docs/cortex/guides/mcp) to register and connect a custom client.