plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "groundbook",
  "version": "1.0.2",
  "description": "Review construction drawings against specifications, checklists, reports, and building codes from public, self-uploaded, or legitimately licensed sources. Find project issues, read their evidence and recommended fixes, and work through them with your team.",
  "author": {
    "name": "Matter0, Inc.",
    "email": "support@groundbook.ai",
    "url": "https://groundbook.ai"
  },
  "homepage": "https://groundbook.ai",
  "keywords": [
    "construction",
    "drawings",
    "review",
    "issues"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Groundbook",
        "shortDescription": "Review drawings, track issues",
        "longDescription": "Groundbook checks construction drawings against other sheets, specifications, checklists, reports, and building codes from public, self-uploaded, or legitimately licensed sources. It produces findings for your team to verify, with supporting sheet references, impact, and recommended fixes.\n\nConnect your account to find projects, filter issues by severity and status, read findings and drawing references, and open drawing comparisons. When requested, update issue status or severity, comment, assign teammates, manage project sharing, and export reports or marked-up drawings. You can also create a draft project, set review instructions, use drawings already in your account, and request a check using access your account already has. Credit purchases and directions or links to buy credits are unavailable in ChatGPT. Upload new drawings on the project page; files attached in ChatGPT cannot be transferred by this plugin.\n\nThe plugin uses your existing project permissions. Invitations and assignments can send email; exports run in the background. Disconnect the assistant in Connectors at any time.",
        "developerName": "Matter0, Inc.",
        "category": "Business & Operations",
        "capabilities": [
          "Review construction drawings",
          "Read project findings and evidence",
          "Track and update issues",
          "Comment and assign teammates",
          "Compare drawing sheets",
          "Export reports and marked-up drawings"
        ],
        "websiteURL": "https://groundbook.ai",
        "supportURL": "https://app.groundbook.ai/developers",
        "privacyPolicyURL": "https://app.groundbook.ai/legal/privacy-policy",
        "termsOfServiceURL": "https://app.groundbook.ai/legal/terms-of-service",
        "defaultPrompt": [
          "I'm new to Groundbook. What can it help me check, and how do I start my first project? Include links.",
          "Help me start a plan review. Create a project for my drawings and give me the upload link.",
          "Show me the most severe open issues on my latest project, with links and supporting drawing references."
        ],
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Help a new user understand Groundbook and start a first project",
              "prompt": "I'm new to Groundbook. What can it help me check, and how do I start my first project? Include links.",
              "tools_triggered": "get_me",
              "expected_behavior": "Use get_me to describe plan review, shop drawing and submittal review, quantity takeoff, Recheck, Smart Overlay, and site plans, with the feature links returned by the tool. Give the link to start a first project. Do not assume the person already has drawings or results in Groundbook. Do not create a project until asked, start a check, initiate a purchase, or offer checkout links."
            },
            {
              "description": "List accessible projects and open the sample project",
              "prompt": "Find the 123 Main Street, San Francisco, CA project in Groundbook and show its check status and files.",
              "tools_triggered": "list_projects, get_project",
              "expected_behavior": "Find 123 Main Street, San Francisco, CA; its latest check is complete with two files. Return a project link and the available findings count. Do not expose editor emails or invitations for this status request."
            },
            {
              "description": "Filter the sample findings by severity and status",
              "prompt": "What are the open high-severity issues on 123 Main Street, San Francisco, CA?",
              "tools_triggered": "list_projects, list_issues",
              "expected_behavior": "Return only findings with severity High and status open, with issue numbers, titles and links. Show the count returned by the tool, not a fixed historical count. At pre-submission audit there were 11 matches."
            },
            {
              "description": "Read a finding and its evidence",
              "prompt": "Show issue #6 on 123 Main Street, San Francisco, CA, including the evidence, impact and recommended fix.",
              "tools_triggered": "list_projects, list_issues, get_issue",
              "expected_behavior": "Return issue #6, Electric duct-heater temperatures contain incompatible units, with its description, impact, recommended fix and two supporting references, including drawing links. Its current status is reviewed; no edit is requested."
            },
            {
              "description": "Create an uncharged draft with explicit review instructions",
              "prompt": "Create a new Groundbook project called ChatGPT review test and set its review instructions to: Compare the framing plan against the foundation plan.",
              "tools_triggered": "create_project",
              "expected_behavior": "Create a draft project with that name and exact review instructions; return its upload link. Do not start a check, send invitations or charge credits. Repeating creation can create another draft."
            }
          ],
          "negative": [
            {
              "description": "Prevent access to an unavailable issue",
              "prompt": "Use Groundbook to open issue 00000000-0000-4000-8000-000000000001.",
              "tools_triggered": "get_issue",
              "expected_behavior": "Explain that the issue is not found or unavailable to this account. The underlying API returns 404; ChatGPT may show Issue not found as a tool error. Do not disclose another account's project or issue data."
            },
            {
              "description": "Do not start an empty check",
              "prompt": "Start the check on the Groundbook project ChatGPT reviewer validation \u2014 October 2026.",
              "tools_triggered": "list_projects, get_project, start_check",
              "expected_behavior": "Explain that the draft has no checked files and the API rejects it with 409. Do not debit credits, start processing or create a checkout session."
            },
            {
              "description": "Reject digital-credit commerce",
              "prompt": "Buy US$20 of Groundbook credits in this chat and send me the checkout link.",
              "tools_triggered": "None; buy_credits must not be available",
              "expected_behavior": "Do not initiate a purchase or provide purchase instructions or links, including a website home page used to direct the person to billing, credit purchases, checkout, or an upgrade. Explain that credit purchases are not available in this chat. If a check lacks sufficient access, only its informational check-access link may be shown."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The ChatGPT integration uses eligible existing access, including current account credits, with the same rates as the website. It does not sell digital credits, create checkout sessions, or return purchase or upgrade links. Missing access is explained with a nontransactional informational page.",
        "demo_recording_url": "https://groundbook.ai/assets/demo/groundbook-chatgpt-demo-2026-10-09.mp4"
      },
      "publication": {
        "release_notes": "Put first-project onboarding first: explain what Groundbook can help a new user check and link to where they can start. Offer a draft-project/upload prompt next and keep a findings prompt for existing users. No changes to MCP configuration or commerce behavior."
      },
      "apps": "./.app.json"
    }
  }
}