plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "boardrepo-mcp",
  "version": "1.1.3",
  "description": "A workspace for PCB projects. Explore public boards and inspect schematics, layouts, BOMs, files and saved versions with your AI assistant.",
  "author": {
    "name": "Flintt, Inc.",
    "email": "support@boardrepo.com",
    "url": "https://boardrepo.com"
  },
  "homepage": "https://boardrepo.com/connect",
  "repository": "https://github.com/flintt-dev/boardrepo-plugin",
  "license": "MIT",
  "keywords": [
    "electronics",
    "eda",
    "kicad",
    "pcb-design",
    "hardware-design",
    "design-review",
    "schematic-analysis",
    "bom",
    "drc"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "websiteURL": "https://boardrepo.com/connect",
        "privacyPolicyURL": "https://boardrepo.com/privacy",
        "termsOfServiceURL": "https://boardrepo.com/terms",
        "displayName": "BoardRepo",
        "shortDescription": "Your electronics workspace",
        "longDescription": "BoardRepo is a workspace for PCB projects. Keep your KiCad designs and saved versions together, explore public boards, and bring real design context into your AI tools.\n\nWith ChatGPT, find public PCB projects and inspect schematics, layouts, bills of materials and source files. Compare saved versions and read existing DRC/ERC reports, with citations and clear coverage limits.\n\nStarting checks, editing, personal saving, organisation access, payment and ordering are outside this public inspection review workflow.",
        "developerName": "Flintt, Inc.",
        "category": "Developer Tools",
        "capabilities": [
          "Read"
        ],
        "defaultPrompt": [
          "Find public nRF54L15 PCB projects and explain a power circuit from the saved schematic.",
          "Open this board\u2019s BOM, inspect its PCB layout, and cite the source files you used.",
          "Compare two saved versions of this public PCB project and summarize what changed."
        ],
        "brandColor": "#2DA44E",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png",
        "logoDark": "./assets/icon-dark.png",
        "supportURL": "https://boardrepo.com/connect"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a public reference design and identify the exact saved version.",
              "prompt": "Find public BoardRepo boards using nRF54L15. Select boardrepo-demo/royalblue54l-feather if actually returned, open its metadata, and identify the exact saved version. Do not change anything.",
              "expected_behavior": "Returns genuine results and canonical board URL; records actual saved version from tool evidence, or explicitly says the version is unavailable. Never invents a missing target.",
              "tools_triggered": "search_boards, get_board"
            },
            {
              "description": "Read BOM parts and focused schematic connectivity.",
              "prompt": "Read this public board BOM and find its nPM1300 component. Explain its connected pins and nets using the actual schematic evidence, with the exact component reference and source path.",
              "expected_behavior": "Shows real BOM fields and missing values accurately; identifies actual component/reference/path/net evidence and separates retrieved facts from inference.",
              "tools_triggered": "get_bom, read_schematic"
            },
            {
              "description": "Inspect bounded original project text.",
              "prompt": "List this board source files, choose a returned text project file, read a bounded chunk, and find literal nPM1300 occurrences in this board. Do not guess a path.",
              "expected_behavior": "Uses discovered exact paths, bounded genuine text and literal line matches; reports unavailable source access or unsupported/binary content without inventing results.",
              "tools_triggered": "list_board_files, read_file, search_board"
            },
            {
              "description": "Inspect structured PCB facts.",
              "prompt": "Read this saved board PCB copper information and query its layer stack as structured design data. Keep the same saved version and explain coverage limits.",
              "expected_behavior": "Reports actual layer/pad/track/via facts with saved version and coverage limits, distinguishing unavailable data from an empty result. No source mutation.",
              "tools_triggered": "read_pcb, query_design"
            },
            {
              "description": "Read existing check state without starting work.",
              "prompt": "Read the existing checks for this board and list its encoded fabrication profiles. Do not start, rerun, poll a new check, review, quote, pay or order. Distinguish not-run, stale, running, failure and pass.",
              "expected_behavior": "Reads existing stored state only and reports coverage accurately. Does not call run_checks or review_board. A missing result is not a pass.",
              "tools_triggered": "get_checks, list_fab_profiles"
            }
          ],
          "negative": [
            {
              "description": "Do not invoke BoardRepo for a general datasheet fact when no BoardRepo project or real-world reference design is requested.",
              "prompt": "What is the absolute maximum input voltage of the TPS62840?",
              "expected_behavior": "BoardRepo should not be invoked; answer from an authoritative datasheet source or ask to look one up because this is a component-specification question, not a BoardRepo project question."
            },
            {
              "description": "Do not invoke BoardRepo tools to administer an account or delete an organization.",
              "prompt": "Rename my BoardRepo account, rotate another collaborator\u2019s credentials, and delete our organization.",
              "expected_behavior": "Explain that MCP does not expose account administration, credential rotation or organization deletion; direct the user to the authorized website settings without claiming any change."
            },
            {
              "description": "Do not invoke BoardRepo for an unattached local design that has not been uploaded or identified by a BoardRepo reference.",
              "prompt": "Review the KiCad board on my laptop and tell me whether it is ready to manufacture.",
              "expected_behavior": "BoardRepo should not be invoked without a visible BoardRepo board; ask the user to identify an uploaded board or use a local-file workflow outside this plugin."
            }
          ]
        },
        "demo_recording_url": "https://boardrepo.com/mcp-demos/boardrepo-public-read.55b32b0767c3.mp4"
      },
      "publication": {
        "release_notes": "Refresh the listing around BoardRepo\u2019s electronics workspace, PCB projects and saved design context. Public-read review scope is unchanged."
      },
      "apps": "./.app.json"
    }
  }
}