{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ew38mz4kvyt6","handle":"hyprpilot-nvim-mcp","url":"https://wellknown.network/agents/hyprpilot-nvim-mcp","links":{"self":"https://wellknown.network/agents/hyprpilot-nvim-mcp/record.json","html":"https://wellknown.network/agents/hyprpilot-nvim-mcp","markdown":"https://wellknown.network/agents/hyprpilot-nvim-mcp/record.md","api":"https://wellknown.network/api/v1/agents/hyprpilot-nvim-mcp","status":"https://wellknown.network/api/v1/agents/hyprpilot-nvim-mcp/status","claim":"https://wellknown.network/agents/hyprpilot-nvim-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hyprpilot-nvim-mcp/claim.json","badge":"https://wellknown.network/agents/hyprpilot-nvim-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hyprpilot-nvim-mcp/history","tools":"https://wellknown.network/api/v1/agents/hyprpilot-nvim-mcp/tools"},"ard":{"identifier":"urn:air::server:hyprpilot-nvim-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hyprpilot-nvim-mcp","summary":"MCP server bridging Neovim editor state into the hyprpilot agent's tool surface.","description":"# hyprpilot-nvim-mcp\n\n`uvx`-runnable MCP server that bridges a running Neovim's editor state into the [`hyprpilot`](https://github.com/hyprpilot/hyprpilot) agent's tool surface.\n\nIt is a pure dispatcher: at boot it attaches to Neovim over its listen socket, queries `require(\"hyprpilot.mcp\").list()` for the tools you registered on the Lua side (via the [`hyprpilot.nvim`](https://github.com/hyprpilot/hyprpilot.nvim) plugin), and re-exposes each one to the agent through FastMCP with its JSON Schema carried through verbatim. It dies at startup if the socket cannot be reached.\n\n## Install in `mcps.json`\n\n```json\n\"hyprpilot-nvim\": {\n  \"command\": \"uvx\",\n  \"args\": [\"hyprpilot-nvim-mcp\"],\n  \"env\": { \"NVIM_LISTEN_ADDRESS\": \"/run/user/1000/nvim.sock\" }\n}\n```\n\n`uvx` fetches the package from PyPI on first run and caches it. The daemon does not expand `${NVIM_LISTEN_ADDRESS}` — inline the literal socket path.\n\n## Run from source\n\n```sh\nuv sync\nuv run hyprpilot-nvim-mcp --nvim-listen-address /run/user/1000/nvim.sock\n```\n\n## Environment\n\nThe Neovim socket is resolved from `--nvim-listen-address` (aliases `--nvim`, `-n`), then `$NVIM_LISTEN_ADDRESS`, then `$NVIM` (set automatically by Neovim in its child processes). The server exits non-zero if none resolve or the socket is unreachable.\n\n- `NVIM_LISTEN_ADDRESS` — path to the running Neovim's listen socket.\n- `NVIM` — fallback socket; Neovim sets it in its child processes.\n- `HYPRPILOT_NVIM_MCP_LOG_LEVEL` — stderr log level (default `INFO`).\n\n## Built-in tools\n\nTwo management tools ship regardless of the Lua registry:\n\n- `healthcheck` — bridge version, socket, connection state, nvim version, registered tool count.\n- `reload_dynamic_tools` — re-discover the Lua registry and diff it against the live tool list.\n\nEvery other tool comes from the Lua side — this package ships no editor tool catalogue of its own.\n\n## Development\n\n```sh\ntask install   # uv sync --all-groups\ntask lint      # ruff format --check + ruff check + mypy\ntask test …","publisher":{"name":"Cenk Kilic","url":null},"homepage":"https://github.com/hyprpilot/hyprpilot-nvim-mcp","repository":"https://github.com/hyprpilot/hyprpilot-nvim-mcp","version":"3.0.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:hyprpilot-nvim-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"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":"hyprpilot-nvim-mcp","registry":"pypi","observedAt":"2026-09-15T16:22:23.279Z","publishedAt":"2026-08-05T16:53:33.588917Z","latestVersion":"3.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hyprpilot-nvim-mcp","url":"https://pypi.org/project/hyprpilot-nvim-mcp/","firstSeenAt":"2026-09-09T17:21:48.522Z","fetchedAt":"2026-09-15T16:21:25.302Z","normalizedAt":"2026-09-15T16:21:25.302Z"}]},"firstSeenAt":"2026-09-09T17:21:48.522Z","updatedAt":"2026-09-15T16:22:23.279Z"}