MCP App Store
by KeenEthics
Groundbook icon

Groundbook MCP Server for Claude and ChatGPT

By Groundbook AI

Overview

Groundbook checks construction drawings for conflicts, missing information, and code problems before bidding, permitting, and construction, so they don't turn into RFIs, change orders, delays, or rework. It's built for everyone who works from a drawing set: • Architects, landscape architects, and designers: coordinate consultant sheets and check details, schedules, and specs before each issue. • Engineers (structural, MEP, civil, fire protection, geotechnical): find cross-discipline clashes and gaps in your sheets and everyone else's. • General contractors and construction managers: review bid and construction sets for constructability problems and likely RFIs. • Subcontractors, estimators, suppliers, manufacturers, and detailers: find every item of your scope across all disciplines and spec sections before you bid, and check shop drawings against the contract set. • Developers, owners, and owner's reps: check the design against your requirements and standards before problems reach budget or schedule. • Plans examiners, building officials, code consultants, and facilities teams: screen permit and record sets against codes and checklists. It reads every sheet and cross-checks plans, sections, details, schedules, and notes against each other and against the specifications; runs your review checklist; and checks building codes: public codes, code books you upload, or codes you hold a license for. Each finding cites the exact sheet and text, with a severity, impact, and recommended fix, and joins an issue list your team works through, with a PDF report and marked-up drawings to share. To start, check your drawings in Groundbook, then go through the results with Claude. Your first project is free. With exactly your permissions, Claude can also list your projects, find and update issues, comment and assign teammates, answer questions about a project's drawings, and export a PDF report, marked-up drawings, a Bluebeam FDF, or a CSV. Disconnect anytime in Settings.

How to connect

  1. Claude: Open the Groundbook listing in the Claude connectors directory and choose Connect. Claude listing Groundbook exposes 37 tools here.
  2. ChatGPT: Open the Groundbook listing in the ChatGPT app directory and choose Connect. ChatGPT listing Groundbook exposes 36 tools here.

Tools

add_code_source

ChatGPT
Sets or replaces a draft project's source for a building code its drawings reference (codeName from get_project codeSources): a public URL, or one of the project's files that is the code book. The public URL may be fetched to read the code. Codes the drawings do not reference cannot be added.

add_saved_files_to_project

ChatGPT
Adds PDFs or DWGs to a draft project's check: saved files, or PDFs or DWGs uploaded in Microsoft 365 Copilot or Teams chat (both from list_saved_files). Groundbook sets each file's type and role; change them only if the user asks.

ask

ChatGPT
Asks Groundbook's project assistant about a project's drawings and issues and saves the conversation. It reads sheets, issues, and schedules and answers with references. Uses the project's chat allowance and existing credits. Repeating a question starts another turn and can use more credits. If status is running, call again with the conversationId and no question to collect the answer.

assign_issue

ChatGPT
Assigns an issue to someone by email and sends an assignment email. A person outside the project is only invited when grantProjectAccess is true. Repeating an existing assignment does not add another assignee; a failed notification may be retried.

comment_on_issue

ChatGPT
Adds a comment to an issue and emails mentioned people. Someone outside the project is only invited when grantProjectAccess is true. Repeating the call adds another comment and can send another notification.

create_project

ChatGPT
Creates a draft for a requested Groundbook drawing check and returns its upload link. Check list_projects and list_saved_files for existing drawings first. The person uploads PDF or DWG drawings on the project page; files attached in this chat cannot be sent to Groundbook. Give the project a name and optionally review instructions. Repeating this call creates another draft.

create_smart_overlay

ChatGPT
Starts a Smart Overlay: drawings laid over each other in two colors to see what differs. Give PDFs already in Groundbook (documentId from get_project files or list_saved_files); one file compares sheets within it, such as two floors. Returns a link: when the person opens it, the sheets are read, the pairs you name (or matching floors) are set up, and each pair is aligned. Nothing is charged here; each new sheet pair the person opens is one overlay, free at first and then paid with credits (the result says how many free ones are left).

delete_comment

ChatGPT
Permanently deletes a comment from an issue, with its attachments. People can delete only their own comments.

delete_project

ChatGPT
Permanently deletes a project with all its files and issues. This cannot be undone. Only the owner can delete.

export_issues

ChatGPT
Builds a PDF report, marked-up drawings, a Bluebeam FDF, or a CSV of a project's issues. Returns an export id; call get_export until it is ready.

get_export

ChatGPT
Progress of an export. When ready, the file can be downloaded from the project page's notifications, or with the CLI.

get_fieldwire_send

ChatGPT
Progress of a send to Fieldwire: how many tasks were created, updated, pinned on a plan, or failed.

get_issue

ChatGPT
One issue in full: description, impact, recommended fix, every sheet reference with the cited text and any drawing overlay that shows it, assignees, its Fieldwire task, and comments.

get_me

ChatGPT
The signed-in account: email, organization, credit balance, a first-project discount or legacy trial credit when it has one, and what Groundbook can do (features, each with where to start it). Also explains purchase availability for this connection. Credit purchases, reloads, and top-ups are not available in this ChatGPT connection. If the person asks to buy credits, explain that purchases are unavailable in this chat. Do not provide purchase instructions or links, including a website home page used to direct them to billing, checkout, or an upgrade. An informational check-access link may explain existing access; it must not lead them into a purchase flow.

get_project

ChatGPT
One project with its check status and progress, files, review instructions, the language its findings are written in, code sources, and price. Set includeSharing only when the person asks about project access or wants to change sharing.

get_smart_overlay

ChatGPT
One saved Smart Overlay: its files and each pair of sheets laid over each other, with whether the pair is aligned and whether an AI-drafted alignment still waits for the person's review.

give_issue_feedback

ChatGPT
Records whether an issue is correct, with optional reasons: important, low_importance, strong_evidence, wrong_or_missing_evidence, duplicate, unclear, related_issue, incorrect, not_relevant, not_yet_important, other. Optional details explain other. Usefulness is one shared value per issue: setting it replaces it for everyone, null clears it, and leaving it out keeps it.

import_from_egnyte

ChatGPT
Copies PDFs or DWGs from the person's connected Egnyte into a draft project. Paths come from list_egnyte_folder. Each file is then analyzed; start_check once every file has finished.

import_from_onedrive

ChatGPT
Microsoft 365 Copilot and Teams only: adds PDFs or DWGs the person uploaded there (they are saved to OneDrive), or any PDF or DWG in their OneDrive, to a draft project. Pass the file names as the person sees them. Files attached in Claude, ChatGPT, or other chats are not in OneDrive: the person uploads them on the project page. Each file is then analyzed; start_check once every file has finished.

list_egnyte_folder

ChatGPT
Subfolders and PDFs in one folder of the person's connected Egnyte. Start at the root and walk down to find the drawings, then add them with import_from_egnyte.

list_issues

ChatGPT
Issues found on a project, most severe first. Filter by severity, status, discipline, label, file, assignee, overlay, comments, usefulness, or text; leave out every filter the person did not ask for. total is how many match; projectTotal and projectCounts cover the whole project. Each issue has a number, the drawing sheets it cites, its outside sources and code sections, whether a drawing overlay shows it, its Fieldwire task, and a link.

list_project_overlays

ChatGPT
The drawing comparisons on a project's Overlays tab: two sheets laid over each other, what the review concluded (issue_found, no_issue_found, inconclusive, or pending when no result is recorded yet), and the issues each one supports. Filter by outcome or text. Each has a link that opens the two drawings together.

list_projects

ChatGPT
Projects this account can open, newest first. Filter by text (address or file name) and status: draft (not started), processing (check running), ready (issues available, or a takeoff delivered while the review still runs: see review), archived (review stopped).

list_saved_files

ChatGPT
PDFs and DWGs saved for reuse by this account or its organization, with the projects that already use them, and (in chatUploads) PDFs or DWGs the person uploaded in Microsoft 365 Copilot or Teams chat. Add either kind to a project with add_saved_files_to_project.

list_smart_overlays

ChatGPT
Smart Overlays this account saved: drawings the person laid over each other in two colors, newest first, each with its files and link. Also how many free overlays are left and what one costs after that.

remove_code_source

ChatGPT
Removes a building code from a draft project's check.

remove_file

ChatGPT
Removes a file from a draft project. The upload is deleted unless it is a saved file.

remove_project_share

ChatGPT
Removes a person's access to a project, or cancels a pending invitation.

send_issues_to_fieldwire

ChatGPT
Sends a project's issues to the person's connected Fieldwire as tasks, pinned on the plan when Fieldwire has that sheet. Sending an issue again updates its task. The Fieldwire project is the one the drawings came from when known; otherwise the result lists the projects to choose from. Returns a send id; call get_fieldwire_send until it is done.

set_file_role

ChatGPT
Marks a file in a draft project as checked (reviewed for issues) or reference (context only), and optionally sets its file type: Drawing, Specifications, Report, Calculations, Code, Supporting document. Every drawing sheet, whatever its discipline, is a Drawing. Groundbook sets both when files are added; change them only if the user asks.

set_review_instructions

ChatGPT
What the check should focus on (at least 20 characters), an optional short title, and whether to check against building codes. Set the person's role and project phase here too; both are required before starting a check. Use values the person supplied.

share_project

ChatGPT
Invite someone by email to a project, sending an invitation email, or turn organization-wide access on or off. Repeating an invitation can send another email.

start_check

ChatGPT
Starts Groundbook's review of a draft project's drawings using existing credits after any first-project discount. If credits do not cover the remaining price, explains the missing access and returns an informational link. Every file must have finished analyzing and at least one must be marked checked. Credit purchases, reloads, and top-ups are not available in this ChatGPT connection. If the person asks to buy credits, explain that purchases are unavailable in this chat. Do not provide purchase instructions or links, including a website home page used to direct them to billing, checkout, or an upgrade. An informational check-access link may explain existing access; it must not lead them into a purchase flow.

unassign_issue

ChatGPT
Removes an assignee from an issue, by assignee id (from get_issue assignees) or by email.

update_issue

ChatGPT
Changes an issue's severity, status (open, reviewed, resolved, dismissed, or a project status), or labels.

update_project

ChatGPT
Rename a project, set the language its findings are written in, or add a custom issue status or discipline to it.

add_code_source

Claude

add_saved_files_to_project

Claude

ask

Claude

assign_issue

Claude

buy_credits

Claude

comment_on_issue

Claude

create_project

Claude

create_smart_overlay

Claude

delete_comment

Claude

delete_project

Claude

export_issues

Claude

get_export

Claude

get_fieldwire_send

Claude

get_issue

Claude

get_me

Claude

get_project

Claude

get_smart_overlay

Claude

give_issue_feedback

Claude

import_from_egnyte

Claude

import_from_onedrive

Claude

list_egnyte_folder

Claude

list_issues

Claude

list_project_overlays

Claude

list_projects

Claude

list_saved_files

Claude

list_smart_overlays

Claude

remove_code_source

Claude

remove_file

Claude

remove_project_share

Claude

send_issues_to_fieldwire

Claude

set_file_role

Claude

set_review_instructions

Claude

share_project

Claude

start_check

Claude

unassign_issue

Claude

update_issue

Claude

update_project

Claude

upload_files

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/groundbook"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/groundbook)