---

name: lsp description: Use when Codex needs language-server diagnostics, definitions, references, symbols, or rename safety checks in the current workspace.

Codex LSP

Call lsp MCP tools through the tool interface; lsp.*/mcp__lsp__* are tool-call names, not shell commands.

Tools

• lsp.status: list configured, installed, missing, disabled, and active language servers.
• lsp.diagnostics: check one file or directory for LSP diagnostics. Prefer severity: "error" after edits.
• lsp.goto_definition: locate a symbol definition from file, line, and character.
• lsp.find_references: find usages of a symbol across the workspace.
• lsp.symbols: inspect document symbols or search workspace symbols.
• lsp.prepare_rename: check whether a rename is valid at a position.
• lsp.rename: apply a language-server workspace edit for a rename.

Config

Project config lives at .codex/lsp-client.json; user config lives at ~/.codex/lsp-client.json.

{
	"lsp": {
		"typescript": {
			"command": ["typescript-language-server", "--stdio"],
			"extensions": [".ts", ".tsx", ".js", ".jsx"]
		}
	}
}

Use lsp.status first when diagnostics report a missing language server.