Cortex MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CORTEX_PORT | No | Dashboard port | 4759 |
| CORTEX_API_PORT | No | REST API port | 3001 |
| CORTEX_PROJECT_PATH | No | Project root directory | . |
| CORTEX_SYNC_ENABLED | No | Enable cloud sync | false |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cortex_initA | Initialize Cortex project. You MUST ask the human ALL 10 onboarding questions FIRST using cortex_ask_human. Do NOT call this tool until you have all answers. The 10 mandatory questions are: 1) Project name, 2) Goal, 3) Tech stack, 4) UI style, 5) Preferred libs, 6) Forbidden libs, 7) File structure, 8) Existing codebase, 9) Core features, 10) Complexity level. |
| cortex_get_stateA | Get compressed project state (under 200 tokens) — call before every action. Includes token budget warning if >50% used. |
| cortex_get_detailC | Get full dictionary entry for a file or feature |
| cortex_get_next_taskA | Get next pending todo - agent always calls this, never decides own next step |
| cortex_log_progressC | Log a completed step |
| cortex_add_featureC | Add a new feature |
| cortex_update_featureC | Update feature status |
| cortex_tick_fileA | Mark a file as created/done in file tree. Saves checkpoint if file exists on disk. |
| cortex_add_testB | Add a test linked to a feature |
| cortex_update_testC | Pass or fail a test |
| cortex_log_issueC | Log a bug or blocker |
| cortex_resolve_issueB | Mark issue resolved with fix description |
| cortex_write_dictionaryC | Write or update a dictionary entry |
| cortex_add_snippetC | Save a code snippet to library |
| cortex_add_researchC | Save library research notes |
| cortex_add_decisionB | Log an architectural decision |
| cortex_check_remindersB | Run all 6 reminder checks — returns list of warnings/blocks based on real DB state |
| cortex_save_snapshotA | Compress current session to summary, save to DB and .cortex/snapshots/ on disk |
| cortex_rollbackB | Restore file to checkpoint |
| cortex_ask_humanA | Force pause, queue a question for human, block until answered via POST /api/human-answer |
| cortex_confirm_destructiveA | Block dangerous actions until human confirms. Shows red modal in dashboard. Falls back to terminal if no dashboard. |
| cortex_healthA | Check DB integrity, missing tests, open issues, broken files. Auto-repairs common problems. |
| cortex_set_active_projectA | Switch active project (loads different .cortex DB). Blocked when process was started with --project (locked to single project). |
| cortex_list_skillsA | List all available Cortex skills — bundled with the package (always available) plus any user-added skills. Returns name, source ("bundled" or "user"), and description for each. |
| cortex_get_skillA | Get the full content of a Cortex skill file. Call this at the start of any session to load the complete agent guide. Works with Claude Code, Gemini, Codex, Cursor, OpenCode, and any MCP client. Defaults to the main "cortex" skill (SKILL.md) if no name is given. |
| cortex_searchA | Search across dictionary, issues, snippets, research, and progress. Supports keyword (FTS5), semantic (vector), and hybrid (RRF fusion) modes. Returns ranked results with source table, id, and matched snippet. |
| cortex_check_contradictionsA | Find conflicting data in the dictionary. If key provided, checks only that entry. If no key, scans recent entries. |
| cortex_resolve_contradictionB | Resolve a contradiction by choosing which version to keep. |
| cortex_log_tokensA | Log token usage for the current action. Call after every tool call. |
| cortex_get_token_budgetB | Get token budget status for the current session. |
| cortex_set_roleA | Set the role for an agent. Roles control which tools the agent can call. |
| cortex_get_roleB | Get the role and permissions for an agent. |
| cortex_list_agentsA | List all connected agents and their roles. |
| cortex_add_relationshipC | Create a relationship between two entities (feature, file, test, issue, decision). |
| cortex_pipeline_startA | Start an autonomous pipeline from a goal. Breaks goal into tasks, executes them, auto-retries failures. |
| cortex_pipeline_statusB | Get the status of a running or completed pipeline. |
| cortex_pipeline_pauseC | Pause the currently running pipeline. |
| cortex_pipeline_resumeB | Resume a paused pipeline. |
| cortex_pipeline_cancelA | Cancel a running or paused pipeline. |
| cortex_pipeline_planA | Preview what tasks a pipeline would create for a goal without starting it. |
| cortex_auto_healA | Auto-detect and fix broken files, failed tests, and other issues. Returns list of healed items. |
| cortex_pipeline_historyB | View recent pipeline runs and their results. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| start-session | Initialize a new Cortex session — call cortex_get_state first, then cortex_get_next_task |
| debug-issue | Structured debugging workflow — log issue, investigate, fix, resolve |
| review-code | Review a file — check for issues, log findings, suggest improvements |
| init-project | Full onboarding workflow — ask 10 questions, then initialize |
| end-session | Wrap up the current session — save snapshot, check final state |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Cortex Skill: audit-checklist | Cortex MCP — Audit & Smoke Test Reference |
| Cortex Skill: cortex | Cortex MCP is a persistent brain, memory, task loop controller, and reminder |
| Cortex Skill: dashboard-spec | Cortex Dashboard — Complete Specification |
| Cortex Skill: schema | Cortex MCP — Database Schema Reference |
| Cortex Skill: tools | Cortex MCP — Tool Contracts (V2) |
| Project State | Current project configuration and status |
| Features | All project features with status |
| File Tree | All tracked files |
| Tests | All tests with status |
| Issues | Open and resolved issues |
| Dictionary | File and feature documentation |
| Progress Log | Recent activity and completed steps |
| Pending Tasks | Next tasks to work on |
| Knowledge Graph | Entity relationships (features, files, tests) |
| Session Snapshots | Session summaries for context restoration |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/neuralnexustech/cortex-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server