BoardRepo

Get a board's DRC and ERC results

get_checks

Read-onlyIdempotent

Use when the user asks whether a board passes KiCad's own checks, or before trusting a design: returns the stored DRC (design rules, unconnected copper, schematic-vs-board parity) and ERC (electrical rules) results for the board's current version, with exact error and warning counts per category and paged example violations. These are KiCad's checks as the board's author configured them, so rules they waived were never evaluated and are listed separately. This is not a design review. If the checks have not been run for this version the result says so, and that is NOT the same as passing.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "board": "<board>"
    },
    "name": "get_checks"
  }
}

Input Schema

Name	Required	Description
`board`	Yes	A board: handle/slug or a boardrepo.com URL. Use search_boards for public boards or list_my_boards for personal and authorised organisation boards. Do not invent references.
`rules`	No	Optional: YOUR OWN limits in millimetres, when no published fab profile fits - an in-house process, a tier a vendor does not publish, or a house rule tighter than any of them. Keys are the same limit names list_fab_profiles reports (trackWidthOuterMm, clearanceOuterMm, drillPlatedMinMm, annularMinMm and so on); values are millimetres. Mutually exclusive with vendor. The result is never stored as if a fab had published it.
`cursor`	No	Opaque pagination cursor from a previous call; pass to fetch the next page of violations.
`vendor`	No	Optional fab house. Known ids: jlcpcb, pcbway, oshpark, multi-cb, eurocircuits, advanced-circuits, seeed, elecrow. A house name or one of that house's profile ids also resolves. Returns geometric checks against that fab's stored profile for this board instead of the board's own DRC/ERC.
`version`	No	Which saved version to read: a version number (3 or "v3"), a versionId from list_board_versions, "latest", or a release tag such as "rev-A". Omit for the latest version. Results echo the version they read; pass its id back to stay on it.
`category`	No	Optional: return only this category's violation details. Counts for every category are always returned regardless.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedNov 8, 2026

changedInput schema / properties / vendor / description

Previous value: -"Optional fab house id from list_fab_profiles. Returns geometric checks against that fab's stored profile for this board instead of the board's own DRC/ERC. Do not invent an id."New value: +"Optional fab house. Known ids: jlcpcb, pcbway, oshpark, multi-cb, eurocircuits, advanced-circuits, seeed, elecrow. A house name or one of that house's profile ids also resolves. Returns geometric checks against that fab's stored profile for this board instead of the board's own DRC/ERC."

addedInput schema / properties / version

Added value: +{
+  "anyOf": [
+    {
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "maxLength": 64,
+      "minLength": 1,
+      "type": "string"
+    }
+  ],
+  "description": "Which saved version to read: a version number (3 or \"v3\"), a versionId from list_board_versions, \"latest\", or a release tag such as \"rev-A\". Omit for the latest version. Results echo the version they read; pass its id back to stay on it."
+}

removedOutput schema / additionalProperties
```
Removed value: -true
```

addedOutput schema / anyOf

Added value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "errorCount": {
+        "type": "integer"
+      },
+      "hasNextPage": {
+        "type": "boolean"
+      },
+      "nextCursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "note": {
+        "type": "string"
+      },
+      "ran": {
+        "type": "boolean"
+      },
+      "vendor": {
+        "type": "string"
+      },
+      "vendorLabel": {
+        "type": "string"
+      },
+      "version": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "latest": {
+            "type": "boolean"
+          },
+          "number": {
+            "type": "integer"
+          },
+          "tags": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "id",
+          "number",
+          "latest",
+          "tags"
+        ],
+        "type": "object"
+      },
+      "violations": {
+        "items": {
+          "additionalProperties": true,
+          "properties": {},
+          "required": [],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "warningCount": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "ran"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "appError": {
+        "type": "string"
+      },
+      "bytesNeeded": {
+        "type": "integer"
+      },
+      "cause": {
+        "type": "string"
+      },
+      "currentHead": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "currentPolicyHash": {
+        "type": "string"
+      },
+      "docsUrl": {
+        "type": "string"
+      },
+      "fix": {
+        "type": "string"
+      },
+      "freeBytes": {
+        "type": "integer"
+      },
+      "issues": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "message": {
+              "type": "string"
+            },
+            "path": {
+              "type": "string"
+            },
+            "received": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "path",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "message": {
+        "type": "string"
+      },
+      "operationId": {
+        "type": "string"
+      },
+      "projectsLeft": {
+        "type": "integer"
+      },
+      "reason": {
+        "type": "string"
+      },
+      "resetsAt": {
+        "type": "string"
+      },
+      "retryAfterMs": {
+        "type": "integer"
+      },
+      "retryable": {
+        "type": "boolean"
+      },
+      "sourceSaved": {
+        "type": "boolean"
+      },
+      "storedResultAvailable": {
+        "type": "boolean"
+      },
+      "suggestions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "board": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "board",
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "uploadLinks": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "bytes": {
+              "type": "integer"
+            },
+            "expiresAt": {
+              "type": "string"
+            },
+            "headers": {
+              "type": "object"
+            },
+            "method": {
+              "const": "PUT"
+            },
+            "path": {
+              "type": "string"
+            },
+            "sha256": {
+              "type": "string"
+            },
+            "uploadUrl": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "path",
+            "bytes",
+            "sha256",
+            "uploadUrl",
+            "method",
+            "headers",
+            "expiresAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "url": {
+        "type": "string"
+      },
+      "visibility": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "reason",
+      "message"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties

Removed value: -{
-  "errorCount": {
-    "type": "integer"
-  },
-  "hasNextPage": {
-    "type": "boolean"
-  },
-  "nextCursor": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "note": {
-    "type": "string"
-  },
-  "ran": {
-    "type": "boolean"
-  },
-  "vendor": {
-    "type": "string"
-  },
-  "vendorLabel": {
-    "type": "string"
-  },
-  "violations": {
-    "items": {
-      "additionalProperties": true,
-      "properties": {},
-      "required": [],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "warningCount": {
-    "type": "integer"
-  }
-}

removedOutput schema / required
```
Removed value: -[
-  "ran"
-]
```

Changed1 schema field changedSep 16, 2026

changedInput schema / properties / vendor / description

Previous value: -"Optional fab house id from list_fab_profiles. Returns that fab's manufacturability verdict for this board instead of the board's own DRC/ERC. Do not invent an id."New value: +"Optional fab house id from list_fab_profiles. Returns geometric checks against that fab's stored profile for this board instead of the board's own DRC/ERC. Do not invent an id."

Changed1 schema field changedSep 16, 2026

changedInput schema / properties / vendor / description

Previous value: -"Optional fab house id. Returns that fab's manufacturability verdict for this board instead of the board's own DRC/ERC. Do not guess an id - if your tool list includes one for listing fab profiles, get the id from there; if it does not, use `rules` with explicit millimetre limits instead."New value: +"Optional fab house id from list_fab_profiles. Returns that fab's manufacturability verdict for this board instead of the board's own DRC/ERC. Do not invent an id."

Changed1 schema field changedSep 14, 2026

changedInput schema / properties / board / description

Previous value: -"A public board: handle/slug (e.g. alice/keezyboost40) or a boardrepo.com URL. Discover it with search_boards; do not invent one."New value: +"A board: handle/slug or a boardrepo.com URL. Use search_boards for public boards or list_my_boards for personal and authorised organisation boards. Do not invent references."

First observedAug 27, 2026

TDQS

A4.4/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare the safety profile (readOnlyHint, idempotentHint, destructiveHint=false), yet the description still adds material behavior: rules waived by the author were never evaluated and are listed separately, and a version with no checks run reports so and is 'NOT the same as passing.' That waiver/never-run caveat is exactly the kind of interpretive context annotations cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with the 'Use when' trigger and stays under a short paragraph with no filler sentences. It is dense to the point of being a single run-on block, but every clause (waivers, never-run, not-a-design-review) carries distinct decision value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only query tool with an output schema and full schema coverage, the description covers everything an agent needs to decide and call correctly: what is returned, how counts versus paged violations differ, when results are absent, and how author-configured rules limit what is checked.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents board, rules, vendor, version, cursor, and category thoroughly, including the rules/vendor mutual exclusion and the cursor's pagination role. The description adds only indirect hints (paged example violations, current-version scoping) rather than new semantics, so the baseline applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it 'returns the stored DRC ... and ERC ... results for the board's current version.' It also enumerates what the categories cover (design rules, unconnected copper, schematic-vs-board parity, electrical rules), which lets an agent distinguish it from siblings like get_board_status or query_design without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit trigger ('when the user asks whether a board passes KiCad's own checks, or before trusting a design') and an explicit exclusion ('This is not a design review'). No sibling tool is named as an alternative, though, so an agent must infer that query_design is the right call for a real design review rather than a check-results read.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All BoardRepo tools Inspect

Try in Browser

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Get a board's DRC and ERC results

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources