revit-api-docs

Revit API reference search as an MCP server: two read-only tools over a local copy of the Revit 2026 API documentation (27,596 classes, methods, properties and enums) and the official SDK samples (153 projects).

Optional. It exists for models that do not know the Revit API well. If your model already writes correct Revit code, you do not need it; revit-bridge works without it. It never talks to Revit and it never calls a model itself.

Queries are English only: the corpus is the English API reference. A host model that talks to its user in another language rewrites the request into English API names or English task keywords before calling a tool.

Install

Prerequisites: Python 3.11+ with uv (for uvx), about 700 MB of disk for the data set, network for the first run.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "revit-api-docs": {
      "command": "uvx",
      "args": ["revit-api-docs"]
    }
  }
}

Claude Code:

claude mcp add revit-api-docs -- uvx revit-api-docs

Any MCP client — run uvx revit-api-docs as a stdio server.

Any MCP client over HTTP — run the server with the MCP streamable HTTP transport and point the client at /mcp:

uvx revit-api-docs serve --transport http --host 127.0.0.1 --port 8765

{
  "mcpServers": {
    "revit-api-docs": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

(Claude Code: claude mcp add --transport http revit-api-docs http://127.0.0.1:8765/mcp.) stdio stays the default. The HTTP transport has no built-in authentication: keep it on a loopback address, or put it behind a reverse proxy that authenticates; the server logs a warning when --host is not a loopback address.

On the first start the server downloads the data set (335 MB, four files) from this repository's v1.0-data release into %LOCALAPPDATA%\revit-api-docs (Windows) or ~/.local/share/revit-api-docs (Linux; ~/Library/Application Support/revit-api-docs on macOS), verifies each file's SHA-256 and unpacks the vector stores. Tool calls made while that runs return a short progress message instead of results. To do it ahead of time:

uvx revit-api-docs download

From a checkout: uv sync then uv run revit-api-docs.

Use

Two tools, both read-only:

• search_revit_api(query, top_k=10) — API entries with signature, parameters and remarks. Query with an API name (Wall.Create, FilteredElementCollector OfCategory) or a short task (create floor from boundary). The first line names the reranker that ordered the entries (jev, cohere or none) and the data set they come from, for example Rerank: none; data set: Revit 2026; after an abstention line it is the second line. Development-environment questions (target framework for Revit 2027 add-in) also get up to five curated environment notes (framework, SDK, manifest, reference packages per Revit release, each with its source); these ship with the package and work before the data set is installed and without any key.
• get_code_examples(query, top_k=3) — C# from the SDK samples that use the matching APIs, with the project name and the APIs each sample touches.

Without any API key the server answers from keyword search over the SQLite reference: BM25 over a full-text index of entry names, IDs, summaries and signatures, where identifiers also match by their camel-case parts, so a misspelt or unknown name still gets candidates. The index (11.8 MB) is built next to the data set on first use (under a second). With an embedding key it adds semantic search over the vector store, and with a Cohere key it reranks the merged candidates; with a TypeSafe key it can rerank with Jev instead, which returns a calibrated relevance per entry. With a threshold set and no entry reaching it, the output starts with an abstention line and then lists the candidates with their relevance, for reference. See Configure.

Try it from a terminal (installs the data set if needed):

uvx revit-api-docs search "Wall.Create"
uvx revit-api-docs search "rotate element around axis" --examples
uvx revit-api-docs environment --revit 2027          # environment notes, no data set needed
uvx revit-api-docs environment "target framework"   # notes a query matches

Configure

All settings are environment variables; there is no config file to edit.

Pass them through the env block of your MCP host's server entry.

Reranking with Jev. If you have a TYPESAFE_API_KEY, REVIT_API_DOCS_RERANK_PROVIDER=jev is the recommended setting (the default provider stays cohere). On 60 English test queries (50 with a known answer) over the keyword (BM25) candidates, with no embedding key, Jev raised nDCG@5 from 0.675 to 0.871 and never turned a correct top-5 answer into a miss. Input tokens cost about $0.23 per 1,000 queries. REVIT_API_DOCS_MIN_RELEVANCE stays unset by default. Set to 0.15 it filters out clearly unrelated queries (questions that are not about Revit, types this data set does not have), abstaining on about 2.5% of the queries that do have an answer. It cannot spot a misspelt or misplaced member name: such a query usually gets the closest real API as the first result, to be confirmed with a compile check. Do not use 0.5: it abstained on 14% of the queries that have an answer. What TypeSafe keeps: see the jev-data-handling note (uvx revit-api-docs environment typesafe).

Privacy: with an embedding, Cohere or TypeSafe key the query text and the candidate API entries (public documentation) are sent to that provider. Keep queries to API names and generic task descriptions, in English.

Data set: the SQLite databases and ChromaDB indexes were built from the Revit 2026 API CHM and the Revit 2026 SDK samples with the pipeline in pipeline/ (uv sync --extra pipeline; needs the CHM, the SDK and OpenRouter/Cohere keys in the environment). The server does not need any of that.

Development:

uv sync
uv run pytest
uv build
uvx --from . revit-api-docs search "Wall.Create"

License: MIT. Issues and discussion: https://github.com/revitbridge/revit-api-docs/issues.