{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_uu7xrxhr8etu","handle":"nvim-mcp","url":"https://wellknown.network/agents/nvim-mcp","links":{"self":"https://wellknown.network/agents/nvim-mcp/record.json","html":"https://wellknown.network/agents/nvim-mcp","markdown":"https://wellknown.network/agents/nvim-mcp/record.md","api":"https://wellknown.network/api/v1/agents/nvim-mcp","status":"https://wellknown.network/api/v1/agents/nvim-mcp/status","claim":"https://wellknown.network/agents/nvim-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/nvim-mcp/claim.json","badge":"https://wellknown.network/agents/nvim-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/nvim-mcp/history","tools":"https://wellknown.network/api/v1/agents/nvim-mcp/tools"},"ard":{"identifier":"urn:air::server:nvim-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"nvim-mcp","summary":"MCP server for AI-assisted control of Neovim via msgpack-RPC","description":"# nvim-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/nvim-mcp)](https://pypi.org/project/nvim-mcp/)\n\n[![nvim-mcp MCP server](https://glama.ai/mcp/servers/paulburgess1357/nvim-mcp/badges/card.svg)](https://glama.ai/mcp/servers/paulburgess1357/nvim-mcp)\n\nAn [MCP](https://modelcontextprotocol.io/) server that gives AI agents first-class access to your running Neovim session. It connects through Neovim's native msgpack-RPC socket — no plugins required.\n\nWorks with Cursor, Claude Code, Codex, OpenCode, and any MCP-compatible client.\n\n_Before you connect an agent to Neovim, please read [Working safely](#working-safely)._\n\n## What agents can do\n\n- **See what you see** — editor mode, working directory, open buffers, window layout, cursor context, folds, selections, marks, and diagnostics.\n- **Edit buffers in memory** — find-and-replace or full rewrites with immediate feedback and full undo support. Nothing touches disk until you save.\n- **Run any Vim command** — `:w`, `:e`, `:vsplit`, macros, or anything else you could type at the command line.\n- **Send keystrokes** — navigate, enter insert mode, trigger mappings.\n- **Query LSP diagnostics** — errors, warnings, and hints across one buffer or the whole session.\n- **Annotate code with highlights and virtual text** — colored line highlights and inline/above/below text notes that never touch the buffer's real content.\n- **Work with multiple instances** — auto-discovers running sessions and connects to the right one. See [multiple instances](docs/MULTIPLE_INSTANCES.md).\n\nAnything you can do in Neovim, the agent can too. See the [full tool reference](docs/TOOLS.md) for details.\n\n## Demos\n\n<details open>\n<summary>Using nvim-mcp across two terminals</summary>\n\n<video src=\"https://github.com/user-attachments/assets/6de3f7a4-9c12-4a2f-96d9-d02d21935d37\"></video>\n\n</details>\n\n<details>\n<summary>Using nvim-mcp with a terminal inside Neovim</summary>\n\n<video src=\"https://github.com/user-attachments/assets/93fd17a6-0f93-48db-8428-d1cba51e…","publisher":{"name":"Paul Burgess","url":null},"homepage":"https://github.com/paulburgess1357/nvim-mcp","repository":"https://github.com/paulburgess1357/nvim-mcp","version":"1.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi: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.terminal","name":"Terminal & Shell","confidence":0.871,"provenance":"derived"},{"slug":"content.writing","name":"Writing & Editing","confidence":0.802,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["content","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":"nvim-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:34.421Z","publishedAt":"2026-10-02T00:26:46.321873Z","latestVersion":"1.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"nvim-mcp","url":"https://pypi.org/project/nvim-mcp/","firstSeenAt":"2026-09-10T08:25:48.609Z","fetchedAt":"2026-11-03T20:28:03.341Z","normalizedAt":"2026-11-03T20:28:03.341Z"}]},"firstSeenAt":"2026-09-10T08:25:48.609Z","updatedAt":"2026-11-03T20:29:34.421Z"}