vera-mcp¶

vera-mcp publishes the vera_mcp Python package and vera-mcp entry point. It depends on vera-doc for storage/search and vera-ingest for viewer helpers (pages, figures, regions, source export). It exposes archive and corpus retrieval as Model Context Protocol tools.

vera_search and vera_corpus_search accept pretty: true to add readable, citation-ready context while retaining their structured result arrays.

The package is a protocol adapter. Ranking, validation, and conversion remain implemented by vera-doc and vera-ingest.

Install¶

From PyPI:

python -m pip install "vera[mcp]>=0.3.0"

Or install the package directly:

python -m pip install "vera-mcp>=0.3.0"

From a repository checkout:

uv run --extra mcp vera mcp

The server communicates over stdio. Do not add --json or write unrelated output to stdout.

Documentation¶

MCP setup and client configuration.
MCP tools — search, corpus search, inspect, validate, figures, figure image fetch, pages, chunk fetch, and regions.
Recommended agent behavior.
Portable Agent Skill.
MCP troubleshooting.

API reference¶

vera_mcp — build_server() and the stdio entry point.

MCP intentionally does not expose conversion, index mutation, source export, or retrieval evaluation. Use vera or the Python packages for those tasks.

Source viewer: vera_show_sources adds an Open VERA sources button beside a normally rendered answer. The user selects [C#] references inside the viewer; vera_source_page loads the highlighted passage. See the plugin source viewer for source-install requirements and preview limits.