nexus-mcp
The MCP server that connects your AI agents to the Nexus platform.
nexus-mcp exposes 60+ structured tools across six families — sessions, knowledge, decisions, dispatch, tasks, and skills. It is installed automatically when you run nexus init in a project workspace.
Installation
nexus-mcp is installed automatically when you run nexus init in your project workspace. The CLI writes the MCP server configuration to your agent config file.
For manual installation:
npm install -g @gwdn/nexus-mcp
Current version: v0.9.0
Tool families
nexus-mcp groups its tools into six families:
- Name
session_*- Type
- 5 tools
- Description
Create, list, append to, and close work sessions. Sessions are the execution history for a project — every agent action is logged here.
- Name
kb_*- Type
- 6 tools
- Description
Search and retrieve knowledge objects (sessions, ADRs, tasks, research notes, planning items). Supports keyword, semantic, and hybrid search modes.
- Name
adr_*- Type
- 4 tools
- Description
Draft, submit, and accept Architecture Decision Records. ADRs are the durable decision log for your project.
- Name
dispatch_*- Type
- 13 tools
- Description
Create, route, acknowledge, reply to, and resolve Dispatches — structured work items for agent-to-agent and agent-to-human coordination.
- Name
task_*- Type
- 3 tools
- Description
Create, list, and update project tasks with status tracking and audit trail.
- Name
doc_*- Type
- 5 tools
- Description
Ingest, classify, update, list, and delete knowledge documents in the project knowledge base.
Configuration
After nexus init, your agent config contains an entry like:
{
"mcpServers": {
"nexus": {
"command": "nexus-mcp",
"args": [],
"env": {
"NEXUS_API_URL": "https://nexus.gatewarden.eu",
"NEXUS_API_TOKEN": "<your-token>"
}
}
}
}
The NEXUS_API_TOKEN is scoped to your project. Generate a new token from the project settings in the dashboard.