Trimble Connect MCP Server

MCP (Model Context Protocol) server exposing all Trimble Connect for Browser APIs documentation. Designed for AI-assisted development of Trimble Connect extensions and applications.

What's included

This MCP server provides structured, searchable documentation for 200+ API endpoints across the entire Trimble Connect platform:

Related MCP server: Torna MCP Server

Available tools

MCP Apps (interactive UI in Trimble Assist)

tc_bcf_dashboard_app and tc_bcf_create_app are MCP Apps: they return an HTML resource (text/html+skybridge) that Trimble Assist renders inline in the chat as a nested iframe.

• The HTML connects to the host via @modelcontextprotocol/ext-apps (loaded from https://esm.sh).

• Initial context is pushed to the app through the tool's structuredContent.

• The create form has two submit paths:

  • Without 3D viewpoint: calls the server tool tc_bcf_create_topic via callServerTool (immediate, server-side, no duplication of logic).

  • With current 3D viewpoint (checkbox, default on): calls sendMessage to ask the agent to create the BCF through the host application's create_bcf_topic tool, which captures the live camera + snapshot + loaded models. This uses only the standard MCP Apps SDK.

• CSP allow-list (esm.sh) is declared in the resource _meta.ui.csp.

Note: the Trimble host-proxy extension (callLocalTool from @trimble-agentic/agentic-mcp-app-tools) would let the app call host tools directly, but that package is private (not on public npm/esm.sh), so it cannot be imported into a server-served HTML app. The sendMessage delegation above achieves the same outcome (viewpoint capture in the host) using only the public SDK.

Installation

Prerequisites

• Node.js >= 18

• npm

Build from source

git clone https://github.com/YOUR_USERNAME/trb-mcp-server-api.git
cd trb-mcp-server-api
npm install
npm run build

Configuration

Cursor IDE

Add to your Cursor MCP settings (.cursor/mcp.json or global settings):

{
  "mcpServers": {
    "trimble-connect": {
      "command": "node",
      "args": ["C:/path/to/trb-mcp-server-api/dist/index.js"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "trimble-connect": {
      "command": "node",
      "args": ["C:/path/to/trb-mcp-server-api/dist/index.js"]
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "trimble-connect": {
      "command": "node",
      "args": ["C:/path/to/trb-mcp-server-api/dist/index.js"]
    }
  }
}

Usage examples

Once configured, the AI assistant can use these tools:

Search for specific API methods:

"Search Trimble Connect docs for viewer selection"

Get a complete API reference:

"Get the viewer-api reference"

Start a new extension project:

"Get the extension starter for a viewer3d extension with React"

Get specific viewer API guide:

"Get the viewer API guide for hierarchy"

List all available docs:

"List all available Trimble Connect documentation"

Project structure

trb-mcp-server-api/
├── src/
│   ├── index.ts                  # MCP server entry point
│   └── data/                     # Structured documentation
│       ├── workspace-api.ts      # Workspace API reference
│       ├── rest-api.ts           # REST API Core v2.0 (basic)
│       ├── rest-api-extended.ts  # REST API extended (activities, clashes, comments, companies, groups, etc.)
│       ├── bcf-api.ts            # BCF Topics API
│       ├── viewer-api.ts         # Viewer 3D API
│       ├── markup-api.ts         # Markup/Annotations API
│       ├── view-api.ts           # View API
│       ├── panels-api.ts         # PropertyPanel, DataTable, ModelsPanel
│       ├── auth.ts               # Authentication (OAuth, tokens)
│       ├── regions.ts            # Region URLs
│       ├── extensions.ts         # Extension types, manifests, embedded
│       ├── sdk.ts                # trimble-connect-sdk (TCPS, Organizer, PSet)
│       ├── typescript-types.ts   # TypeScript interfaces
│       ├── project-setup.ts      # Architecture, proxy, Vite, deployment
│       ├── code-examples.ts      # Code skeletons and patterns
│       ├── property-set.ts       # Property Set Service
│       └── pitfalls.ts           # Common pitfalls and solutions
├── dist/                         # Compiled output
├── package.json
├── tsconfig.json
└── README.md

Updating documentation

To add or update API documentation:

1. Edit the relevant file in src/data/

2. Run npm run build

3. Restart the MCP server (or reconnect in Cursor)

Source documentation

• Workspace API — npm

• Workspace API — Reference

• Core API — Developer docs

• BCF Topics — Swagger

• Modus 2.0 — Design System

• Developer Portal

License

MIT