Metadata-Version: 2.4
Name: cortex-memory-mcp
Version: 0.2.1
Summary: Stdio MCP server for Cortex memory
Project-URL: Repository, https://github.com/Ubundi/cortex
Author: Ubundi
License-Expression: LicenseRef-Proprietary
Keywords: ai-agents,cortex,mcp,memory
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28.0
Requires-Dist: mcp<3.0.0,>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: starlette>=0.37.0
Requires-Dist: structlog>=24.0.0
Description-Content-Type: text/markdown

# cortex-memory-mcp

`cortex-memory-mcp` is the thin stdio bridge for Cortex's generic agent-memory
contract. It calls the hosted Cortex HTTP API; it does not contain a local
memory database or memory dashboard.

## Run

```bash
CORTEX_API_KEY=ck_live_... uvx cortex-memory-mcp
```

`CORTEX_BASE_URL` defaults to Cortex production. A scoped connection key derives
its identity, capabilities, accessible spaces, and default space from
`/v1/whoami`; keys are never MCP tool arguments.

Writes are disabled by default. Set `CORTEX_MCP_ENABLE_WRITES=true` to register
remember, correct, move, and confirmed forget tools. Other settings:

- `CORTEX_MCP_PROFILE=generic|integration` (default `generic`)
- `CORTEX_MCP_TIMEOUT_SECONDS=25`
- `CORTEX_MCP_WRITE_TIMEOUT_SECONDS=25`
- `CORTEX_MCP_DEFAULT_USER_ID` only for legacy dedicated keys without exact user scope
- `CORTEX_MCP_ALLOW_USER_OVERRIDE=true` only for approved private integration use

Hosted streamable HTTP exposes the same generic contract at the Cortex API base
URL plus `/mcp`, using the same scoped key as an `x-api-key` header.

Source version `0.2.1` uses the stable Python MCP SDK 2.x. It negotiates MCP
`2026-07-28` through `server/discover` by default and remains compatible with
legacy initialize-based clients.
