Trimble Connect 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:

Category	Description
Workspace API	SDK connection, namespaces (project, user, extension, ui, viewer, embed), events
REST API (Core v2.0)	Projects, files, folders, todos, views, search, regions
REST API Extended	Activities, clashes (full CRUD), 2D views, comments, companies, groups, object links, object sync, releases, shares, tags, users, view groups, extended files/folders/projects/views endpoints
BCF API	BIM Collaboration Format — topics, comments, viewpoints
Viewer 3D API	Camera, selection, objects, models, hierarchy, section planes, icons, layers, point clouds
Markup API	Annotations — text, arrows, lines, clouds, measurements, points, freelines
View API	Saved 3D views (CRUD via Workspace API)
Panels API	PropertyPanel, DataTable, ModelsPanel
Authentication	OAuth 2.0, integrated mode (Workspace API), standalone mode, token management
Regions	URLs per region (US, EU, APAC, AU) for Core API and BCF API
Extensions	Types (project, viewer3d, embedded), manifests, installation guide
Property Set Service	Custom property sets for BIM model objects, libraries, definitions, instances
Trimble Connect SDK	trimble-connect-sdk npm package — TCPS Client, Organizer (LBS/WBS), PSet SDK, Credentials
TypeScript Types	All interfaces (Vector3, Camera, ObjectProperties, BCFTopic, ViewerSelection, etc.)
Project Setup	Architecture, folder structure, backend proxy, Vite config, deployment
Code Examples	Extension skeletons, React hooks, ViewerBridge pattern, annotation workflow
Pitfalls	Common bugs and validated solutions for Trimble Connect extensions

Available tools

Tool	Description
search_trimble_connect_docs	Full-text search across all documentation
get_api_reference	Get complete reference for a specific API category
get_extension_starter	Get a starter template for a new extension (project/viewer3d/embedded)
get_viewer_api_guide	Get detailed guide for a specific Viewer 3D topic
list_available_docs	List all available documentation sections
tc_bcf_dashboard_app	MCP App: interactive Trimble Connect BCF dashboard rendered inside Trimble Assist
tc_bcf_create_app	MCP App: interactive form to create a BCF topic, rendered inside Trimble Assist (submits via tc_bcf_create_topic)

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