{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_br6bhrbtngb3","handle":"codex-lsp-mcp","url":"https://wellknown.network/agents/codex-lsp-mcp","links":{"self":"https://wellknown.network/agents/codex-lsp-mcp/record.json","html":"https://wellknown.network/agents/codex-lsp-mcp","markdown":"https://wellknown.network/agents/codex-lsp-mcp/record.md","api":"https://wellknown.network/api/v1/agents/codex-lsp-mcp","status":"https://wellknown.network/api/v1/agents/codex-lsp-mcp/status","claim":"https://wellknown.network/agents/codex-lsp-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codex-lsp-mcp/claim.json","badge":"https://wellknown.network/agents/codex-lsp-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/codex-lsp-mcp/history","tools":"https://wellknown.network/api/v1/agents/codex-lsp-mcp/tools"},"ard":{"identifier":"urn:air::server:codex-lsp-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codex-lsp-mcp","summary":"MCP server exposing read-only LSP navigation tools for Codex","description":"# codex-lsp-mcp\n\n`codex-lsp-mcp` is a local MCP stdio server that exposes read-only LSP navigation tools to Codex.\n\nBuilt-in defaults target `clangd` for C/C++ and `pyright` for Python; additional\nLSP backends can be configured in `~/.config/codex-lsp-mcp/config.toml`.\n\n## Quick start\n\nRun the published package from PyPI:\n\n```bash\nuvx codex-lsp-mcp\n```\n\n## Local development\n\n```bash\nuv run pytest\nuvx --from . codex-lsp-mcp\n```\n\n## Codex configuration\n\n```bash\ncodex mcp add codex-lsp-mcp -- uvx codex-lsp-mcp\n```\n\nCheck registration:\n\n```bash\ncodex mcp get codex-lsp-mcp\n```\n\nIf `clangd` is not on Codex's `PATH`, set:\n\n```toml\n[mcp_servers.codex-lsp-mcp.env]\nCLANGD_BIN = \"/path/to/clangd\"\n```\n\nFor Python navigation, ensure `pyright-langserver` is on Codex's `PATH`.\nIf pyright is installed in a non-standard location, override the built-in\nbackend in `~/.config/codex-lsp-mcp/config.toml`:\n\n```toml\n[servers.pyright]\ncommand = \"/home/miot/.local/share/nvim/mason/bin/pyright-langserver\"\nargs = [\"--stdio\"]\nroot_markers = [[\"pyrightconfig.json\"], [\"pyproject.toml\"], [\"setup.py\"], [\"setup.cfg\"], [\"requirements.txt\"], [\"Pipfile\"], [\"poetry.lock\"], [\".git\", \".repo\"]]\nworkspace_hint_extension = \".py\"\n\n[servers.pyright.extension_to_language]\n\".py\" = \"python\"\n```\n\nThe server discovers the closest `compile_commands.json` from the queried file path.\n\nTool coordinates follow the LSP convention: zero-based `line` and `character`.\n\n## Workspace roots\n\nFile-oriented tools (`definition`, `references`, `hover`, `diagnostics`, and\n`document_symbols`) accept an optional `root_hint` argument. Use it when `file`\nis relative or when the MCP server process is not running from the project root:\n\n```json\n{\n  \"file\": \"miio_test/cli.py\",\n  \"line\": 86,\n  \"character\": 18,\n  \"root_hint\": \"/home/miot/Work/miot/tool/miio_test\"\n}\n```\n\nAbsolute `file` paths are not rewritten by `root_hint`, but the hint is still\nused as the fallback workspace root when no server-specific root marker is\nfound. Server-speci…","publisher":null,"homepage":null,"repository":null,"version":"0.3.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:codex-lsp-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codex-lsp-mcp","registry":"pypi","observedAt":"2026-11-09T02:25:45.365Z","publishedAt":"2026-05-08T03:57:00.683241Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codex-lsp-mcp","url":"https://pypi.org/project/codex-lsp-mcp/","firstSeenAt":"2026-09-09T12:27:08.110Z","fetchedAt":"2026-11-09T02:24:23.567Z","normalizedAt":"2026-11-09T02:24:23.567Z"}]},"firstSeenAt":"2026-09-09T12:27:08.110Z","updatedAt":"2026-11-09T02:25:45.365Z"}