Exchange BCF issue topics, comments, and viewpoints between BIM tools using the BCF REST API
domain: github.com/buildingSMART/BCF-API · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate via OAuth2 and discover server capabilities with GET /bcf/{version}/auth and GET /bcf/{version}/current-user
List projects with GET /bcf/{version}/projects, then list a project's topics with GET /bcf/{version}/projects/{project_id}/topics, optionally with $filter and $orderby
Create a topic with POST /bcf/{version}/projects/{project_id}/topics, then add discussion with POST .../topics/{guid}/comments
Attach a viewpoint (camera position plus visible/colored/selected components) with POST .../topics/{guid}/viewpoints; retrieve its rendered image via GET .../viewpoints/{guid}/snapshot
Treat viewpoints as immutable - create a new viewpoint rather than editing an existing one when the visualization needs to change
Known gotchas
BCF-API versions (1.0, 2.1, 3.0) differ in endpoint shape and available filters - the version segment in the URL path is not just cosmetic
$filter query syntax (e.g. assigned_to eq '...' and topic_status eq 'Open') is OData-style and only supported on specific list endpoints, not universally
BCF file exchange (.bcfzip) and the BCF REST API are two different integration modes for the same standard - confirm which one a given tool actually implements
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?