@code-context-engine/mcp

Remote MCP server for Context Engine. One tool — codebase_context — for Claude Code, Cursor, Windsurf, and any MCP client.

Install (always latest)

MCP clients should invoke via npx so each session pulls the current release:

npx -y @code-context-engine/mcp@latest

Or install globally (also tracks latest on reinstall):

npm install -g @code-context-engine/mcp@latest
context-engine

MCP config

1. Sign in at codesay.ai with GitHub.
2. Copy your cek_… API key from the console.
3. Paste into your MCP settings:

{
  "mcpServers": {
    "context-engine": {
      "command": "npx",
      "args": ["-y", "@code-context-engine/mcp@latest"],
      "env": {
        "CONTEXT_ENGINE_REMOTE_API_KEY": "<your cek_ key>"
      }
    }
  }
}

No CONTEXT_ENGINE_REMOTE_URL needed — defaults to https://api.codesay.ai.

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CONTEXT_ENGINE_REMOTE_API_KEY | yes | — | User API key (cek_…) from the web console | | CONTEXT_ENGINE_REMOTE_URL | no | https://api.codesay.ai | Remote HTTP service base URL | | CONTEXT_ENGINE_REMOTE_MAX_FILE_BYTES | no | 1048576 | Skip local files larger than this when syncing | | CONTEXT_ENGINE_REMOTE_TIMEOUT_MS | no | 120000 | Per-request HTTP timeout (ms); raise for first sync of large repos |

Tool: codebase_context

Required: path (repo root), query (natural language or symbols).

Optional: token_budget, mode (hybrid / semantic / keyword), ext_filter, path_prefix, max_files, feedback.

Only retrieval calls that return a context pack count against billing quota. Sync, indexing, and feedback are free.

Programmatic use

import { createRemoteMcpServer, runCodebaseContext } from '@code-context-engine/mcp';

License

MIT