MCP Server Reference

Knowledge

Access and search your project's structured knowledge base. Documents are stored in .sidstack/knowledge/ as markdown files with frontmatter.

knowledge_context

Build session context for Claude from linked entities (task, module, spec, ticket). Returns formatted markdown ready for injection into agent prompts.

knowledge_context({
  projectPath: "/path/to/project",
  moduleId: "auth",
  taskId: "task-123"
})

knowledge_search

Search across all knowledge documents. Returns matching documents with summaries. Searches in title, ID, summary, module, and tags.

knowledge_search({
  projectPath: "/path/to/project",
  query: "authentication flow",
  type: ["business-logic", "api-endpoint"]
})

knowledge_list

List all knowledge documents from .sidstack/ (knowledge, skills, principles, modules). Returns summaries without full content.

knowledge_list({
  projectPath: "/path/to/project",
  type: ["api-endpoint"],
  module: "auth"
})

knowledge_get

Get a single knowledge document by ID with full content, metadata, related documents, and dependencies.

knowledge_get({
  projectPath: "/path/to/project",
  docId: "auth-login-flow"
})

knowledge_modules

List all modules with their knowledge document counts and types. Useful for understanding project structure.

knowledge_modules({
  projectPath: "/path/to/project"
})

Tasks

Create and manage tasks with governance auto-linking, quality gates, and smart filtering.

task_create

Create a new task with governance auto-linked based on task type. Accepts title in [TYPE] format, description, priority, and acceptance criteria.

task_create({
  projectId: "my-project",
  title: "[feature] Add OAuth2 login",
  description: "Implement OAuth2 flow with Google provider...",
  taskType: "feature",
  priority: "high"
})

task_update

Update task status, progress, or notes. Use to track work progress through the task lifecycle.

task_update({
  taskId: "task-123",
  status: "in_progress",
  progress: 50,
  notes: "Completed API endpoints, starting UI"
})

task_list

List tasks with smart filtering. Presets: actionable (default), blocked, recent, epics, all. Supports search, status, type, and priority filters.

task_list({
  projectId: "my-project",
  preset: "actionable"
})

task_get

Get a task by ID with full details including governance links, acceptance criteria, and history.

task_get({ taskId: "task-123" })

task_complete

Complete a task with governance validation. Validates quality gates and blocks if requirements not met. Use force=true to bypass (logs violation).

task_complete({
  taskId: "task-123",
  agentId: "worker-1"
})

Impact Analysis

Analyze planned changes for scope, risks, data flows, and generate validation checklists before implementation.

impact_analyze

Run impact analysis on a planned change. Analyzes scope (affected modules, files), risks (severity, blocking status), data flows, and generates a validation checklist.

impact_analyze({
  description: "Add OAuth2 authentication",
  projectId: "my-project",
  changeType: "feature",
  targetModules: ["auth", "api"]
})

impact_check_gate

Check the implementation gate status for an analysis. Returns blocked, warning, or clear status with details about blockers.

impact_check_gate({
  taskId: "task-123"
})

impact_list

List impact analyses for a project, task, or spec. Filter by status (pending, analyzing, completed, failed).

impact_list({
  projectId: "my-project",
  status: "completed"
})

Tickets

External issue intake from Jira, GitHub, Linear, or manual entry. Triage, review, and convert to tasks.

ticket_create

Create a new ticket from external source or manual input. Supports types: bug, feature, improvement, task, epic.

ticket_create({
  projectId: "my-project",
  title: "Login fails on slow connections",
  type: "bug",
  priority: "high",
  source: "github",
  externalId: "#456"
})

ticket_list

List tickets with optional filters by status, type, and priority.

ticket_list({
  projectId: "my-project",
  status: ["new", "reviewing"]
})

ticket_update

Update a ticket's status, priority, assignee, or labels.

ticket_update({
  ticketId: "ticket-456",
  status: "approved",
  assignee: "dev-team"
})

ticket_convert_to_task

Convert a ticket to a governed task for agent execution. Automatically maps ticket type to task type (bug->bugfix, feature->feature, etc.).

ticket_convert_to_task({
  ticketId: "ticket-456"
})

Training Room

Lessons-learned system. Create lessons from incidents and check applicable rules for continuous improvement.

lesson_create

Create a lesson from one or more incidents. Captures what went wrong (problem), why (root cause), and how to prevent it (solution).

lesson_create({
  projectPath: "/path/to/project",
  moduleId: "auth",
  title: "Always validate JWT expiry",
  problem: "Expired tokens were accepted",
  rootCause: "Missing expiry check in middleware",
  solution: "Add exp validation to auth middleware"
})

rule_check

Get applicable rules for a given context. Use before performing actions to check what rules apply based on module, role, and task type.

rule_check({
  projectPath: "/path/to/project",
  moduleId: "auth",
  role: "dev",
  taskType: "feature"
})

Sessions

Launch Claude Code sessions in external terminals with task context, governance skills, and training injected.

session_launch

Launch a Claude Code session in an external terminal. Optionally links to a task, module, and includes training context (skills, rules) in the session prompt.

session_launch({
  projectDir: "/path/to/project",
  taskId: "task-123",
  moduleId: "auth",
  agentRole: "dev",
  includeTraining: true
})

OKRs

Track project Objectives and Key Results. Data stored in .sidstack/project-okrs.json.

okr_list

List project OKRs with progress summary. Shows yearly overview, quarterly breakdown, objectives, and key results with current progress.

okr_list({
  projectPath: "/path/to/project",
  quarter: "Q1-2026"
})

okr_update

Update progress for one or more Key Results. Use after completing features, milestones, or significant deliverables.

okr_update({
  projectPath: "/path/to/project",
  updates: [{ krId: "KR-1.1", progress: 75 }],
  reason: "Shipped knowledge editor v1"
})