Skip to main content

MCP Server

The Paracore MCP (Model Context Protocol) server lets AI coding tools — Claude Desktop, Cline in VS Code, Cursor, and other MCP-compatible clients — interact with Revit directly. It exposes the same REPL engine that powers the Paracore Agent, giving external AI tools the ability to explore your model's schema and execute C# scripts in Revit.

The MCP server is installed alongside the Paracore Revit Add-in at:

C:\ProgramData\Paracore\MCP\paracore-mcp.exe

Prerequisites

  • The Paracore Revit Add-in must be installed (v4.5.0+).
  • The Paracore Server toggle in the Revit ribbon must be On.
  • Revit must be running with a document open.

The Paracore Desktop App is not required for MCP usage — the MCP server talks directly to the Revit Add-in. However, having the Desktop App is useful for experimenting with agent-generated REPL snippets, viewing charts, and managing your script library.


Claude Desktop

  1. Open or create the Claude Desktop configuration file:

    • Windows Store version:
      %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

    • MSI/Installer version:
      %APPDATA%\Claude\claude_desktop_config.json

  2. Add the paracore server entry:

{
"mcpServers": {
"paracore": {
"command": "C:\\ProgramData\\Paracore\\MCP\\paracore-mcp.exe"
}
}
}
  1. Restart Claude Desktop. You should see a hammer icon in the chat input — Paracore tools are now available.

Verify It's Working

In Claude Desktop, ask: "List the wall types in my Revit model." If Claude can explore your model, the MCP connection is active.


Cline (VS Code)

  1. Open VS Code with Cline installed.

  2. Open or create the Cline MCP settings file at:
    %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

  3. Add the paracore server entry:

{
"mcpServers": {
"paracore": {
"autoApprove": [
"ping",
"execute_dynamic_query",
"search_schema",
"read_extension_methods"
],
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "C:\\ProgramData\\Paracore\\MCP\\paracore-mcp.exe",
"args": [],
"env": {}
}
}
}
  1. Save and restart Cline. Paracore tools will appear in Cline's tool list.

Cursor

  1. Open Cursor.
  2. Go to Settings → MCP and add a new MCP server.
  3. Set the command to C:\ProgramData\Paracore\MCP\paracore-mcp.exe.
  4. Paracore tools will appear in Cursor's agent panel.

Available Tools

Once connected, the MCP server provides these tools to the AI client:

ToolDescription
explore_revit_dataRuns read-only C# snippets to inspect your Revit model — parameters, categories, element properties. Results are summarized to avoid token flooding.
execute_dynamic_queryGenerates and executes C# code in Revit. Requires your approval before running — the AI cannot mutate your model without confirmation.
search_schemaFast parameter lookup from an in-memory cache. Returns parameter names, storage types, and type vs instance classification.
read_extension_methodsReturns Paracore's fluent DSL reference so the AI knows which extension methods are available (with fuzzy keyword search).

The MCP server also exposes Paracore's DSL documentation as MCP Resources — the AI client can read paracore://extension-methods and paracore://repl-guide to learn the correct syntax before generating code.


MCP Server vs In-App Agent

MCP ServerIn-App Agent
InterfaceYour AI tool's native chatParacore Desktop App
SetupJSON config fileSettings → LLM Settings
CapabilitiesSame tools, same engineSame tools, same engine
Thinking stepsDepends on host AI toolBuilt-in step visibility
SessionsManaged by host AI toolNamed, persistent sessions
Best forUsers who already use Claude/Cursor/ClineAll-in-one Paracore workflow

Troubleshooting

ProblemSolution
Tools don't appear in Claude DesktopCheck the JSON path in claude_desktop_config.json — use double backslashes (\\). Make sure the file is valid JSON (trailing commas will break it).
MCP server starts but can't reach RevitEnsure Revit is running with a document open and the Paracore Server toggle is On.
explore_revit_data returns empty resultsThe document must have elements loaded. Open a view with model elements visible.