lid-mcp MCP Server

Table of contents

1. lid-mcp MCP Server
   1. Configuration
      1. Supported clients
      2. Claude Desktop (macOS)
      3. Cursor
      4. Windsurf
      5. GitHub Copilot (VS Code)
      6. Claude Code / other stdio clients
   2. Tools
      1. spec_prefix parameter
   3. Typical agent workflow

---

lid-mcp is a stdio MCP server — AI agents call its tools to inspect and modify a LID project with the same integrity guarantees as the LSP and CLI.

---

Configuration

Supported clients

Client	Config location
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Cursor	~/.cursor/mcp.json (global) or .cursor/mcp.json at project root
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot (VS Code)	VS Code settings.json or .vscode/mcp.json at project root
Claude Code	.mcp.json at project root

Claude Desktop (macOS)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "lid": { "command": "lid-mcp" }
  }
}

Cursor

Global (~/.cursor/mcp.json) or per-project (.cursor/mcp.json at project root — takes precedence):

{
  "mcpServers": {
    "lid": {
      "command": "lid-mcp",
      "args": []
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "lid": {
      "command": "lid-mcp",
      "args": [],
      "type": "stdio"
    }
  }
}

GitHub Copilot (VS Code)

In VS Code settings.json:

{
  "mcp": {
    "servers": {
      "lid": {
        "type": "stdio",
        "command": "lid-mcp",
        "args": []
      }
    }
  }
}

Or per-project via .vscode/mcp.json:

{
  "servers": {
    "lid": { "type": "stdio", "command": "lid-mcp", "args": [] }
  }
}

Claude Code / other stdio clients

Add .mcp.json at your project root:

{
  "servers": {
    "lid": { "type": "stdio", "command": "lid-mcp" }
  }
}

First call: Always invoke lid_discover with the absolute project root before using any other tool. It registers the project in the server’s in-memory store and returns the root path used by all subsequent calls.

---

Tools

Tool	Description
lid_init	Scaffold a new LID project — creates index.yaml, arrow doc stub, and intent files (*-specs.md with prefix: frontmatter, *-design.md)
lid_discover	Find and register a LID project; returns root and segment count
lid_status	Segment overview with spec counts
lid_check	Run coherence checks; returns all findings
lid_list_segments	List all segments with status and detail path
lid_get_segment	Full detail for one segment including spec lines
lid_list_specs	All spec lines; optional segment-ID prefix filter
lid_find_spec_references	Source-code locations citing @spec SPEC-ID
lid_search	Case-insensitive search across segment IDs, spec IDs, and text
lid_add_segment	Add a new segment to the arrow index and scaffold its intent files
lid_update_segment	Update status, next, drift, blocks, children, or parent on an existing segment
lid_add_spec	Append a new open spec line to a segment
lid_update_spec_status	Mark a spec open / implemented / deferred
lid_update_spec_text	Rewrite the requirement text of an existing spec line (preserves ID and status)
lid_read_file	Read any file within the project root (design docs, arrow docs, spec files)
lid_append_to_design_doc	Append markdown content to a segment’s design doc; creates file with stub header if absent

spec_prefix parameter

Both lid_init and lid_add_segment accept an optional spec_prefix field. When omitted, the prefix is derived from the segment’s position in the design tree following the LID 1.2.0 path-coherent convention: a segment at docs/intent/{parent}/{seg}/ gets prefix PARENT-SEG; a top-level segment gets SEG. For example, adding gateway under payment under checkout produces CHECKOUT-PAYMENT-GATEWAY.

---

Typical agent workflow

1. lid_discover("/path/to/project")           → registers root, returns segment count
2. lid_status()                               → overview of all segments and spec coverage
3. lid_get_segment("auth")                    → full detail including spec lines
4. lid_read_file("docs/intent/auth/auth-design.md") → read design doc prose
5. lid_append_to_design_doc("auth", "## Decision\n...") → record intent in LLD
6. lid_add_spec("auth", "AUTH-042", "The system shall …") → add EARS spec line
7. lid_find_spec_references("AUTH-002")       → source files citing this spec
8. lid_update_spec_status("AUTH-002", "implemented")
9. lid_check()                                → verify no coherence regressions