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.

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-cli[mcp]>=0.2.2"

Or install the package directly:

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

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, pages, 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-cli or the Python packages for those tasks.