PartsPlan

Reference circuits for a part (metadata)

reference_circuits

Read-onlyIdempotent

Finds where the requested manufacturer's datasheet prints application/example circuits for a part (manufacturer required): datasheet_circuit_locations gives the page, title and location of each circuit heading or figure we found, with page-image and figure-data requests — the figure itself shows the parts, values and wiring; circuits are not transcribed. related_documents lists up to 3 manufacturer design documents (reference designs, user guides) that print this exact part number; a printed part number does not establish that a design uses or suits the part. circuits and candidate_circuits are secondary lists and are usually empty; candidate_circuits entries (for reference only) are unreviewed component lists with no connections and an unverified page and manufacturer label. Nothing here is an electrical-fitness guarantee. Recipes and board-design records from our collection are not included.

Input Schema

Name	Required	Description
`mpn`	No
`brand`	No	Required unless part_id is given
`limit`	No
`part_id`	No	Opaque id from search_parts (preferred; supplies brand + mpn)

Output Schema

Name	Required	Description	Default
`note`	No
`part`	No
`reason`	No
`status`	Yes
`message`	No
`circuits`	No
`excluded`	No
`retryable`	No
`candidates`	No
`doc_sha256`	No
`request_id`	No
`retry_after_ms`	No
`withdrawn_note`	No
`related_documents`	No
`candidate_circuits`	No
`datasheet_circuit_locations`	No
`withdrawn_documents_omitted`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 24, 2026

addedOutput schema / properties / related_documents

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "items": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "applicability": {
+            "const": "not_assessed",
+            "type": "string"
+          },
+          "doc_sha256": {
+            "pattern": "^[0-9a-f]{64}$",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "reference_design",
+              "user_guide"
+            ],
+            "type": "string"
+          },
+          "link_basis": {
+            "const": "exact_part_number",
+            "type": "string"
+          },
+          "next_steps": {
+            "additionalProperties": false,
+            "properties": {
+              "map_request": {
+                "additionalProperties": false,
+                "properties": {
+                  "doc_sha256": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "doc_sha256"
+                ],
+                "type": "object"
+              },
+              "page_text_request": {
+                "additionalProperties": false,
+                "properties": {
+                  "doc_sha256": {
+                    "type": "string"
+                  },
+                  "page": {
+                    "const": 1,
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "doc_sha256",
+                  "page"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "map_request",
+              "page_text_request"
+            ],
+            "type": "object"
+          },
+          "pages": {
+            "maximum": 9007199254740991,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "part_maker": {
+            "type": "string"
+          },
+          "publisher": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "doc_sha256",
+          "kind",
+          "title",
+          "publisher",
+          "part_maker",
+          "link_basis",
+          "applicability",
+          "next_steps"
+        ],
+        "type": "object"
+      },
+      "maxItems": 3,
+      "minItems": 1,
+      "type": "array"
+    },
+    "more": {
+      "maximum": 9007199254740991,
+      "minimum": 1,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "items"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 24, 2026

removedOutput schema / properties / related_documents

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "items": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "applicability": {
-            "const": "not_assessed",
-            "type": "string"
-          },
-          "doc_sha256": {
-            "pattern": "^[0-9a-f]{64}$",
-            "type": "string"
-          },
-          "kind": {
-            "enum": [
-              "reference_design",
-              "user_guide"
-            ],
-            "type": "string"
-          },
-          "link_basis": {
-            "const": "exact_part_number",
-            "type": "string"
-          },
-          "next_steps": {
-            "additionalProperties": false,
-            "properties": {
-              "map_request": {
-                "additionalProperties": false,
-                "properties": {
-                  "doc_sha256": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "doc_sha256"
-                ],
-                "type": "object"
-              },
-              "page_text_request": {
-                "additionalProperties": false,
-                "properties": {
-                  "doc_sha256": {
-                    "type": "string"
-                  },
-                  "page": {
-                    "const": 1,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "doc_sha256",
-                  "page"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "map_request",
-              "page_text_request"
-            ],
-            "type": "object"
-          },
-          "pages": {
-            "maximum": 9007199254740991,
-            "minimum": 1,
-            "type": "integer"
-          },
-          "part_maker": {
-            "type": "string"
-          },
-          "publisher": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "doc_sha256",
-          "kind",
-          "title",
-          "publisher",
-          "part_maker",
-          "link_basis",
-          "applicability",
-          "next_steps"
-        ],
-        "type": "object"
-      },
-      "maxItems": 3,
-      "minItems": 1,
-      "type": "array"
-    },
-    "more": {
-      "maximum": 9007199254740991,
-      "minimum": 1,
-      "type": "integer"
-    }
-  },
-  "required": [
-    "items"
-  ],
-  "type": "object"
-}

Changed1 schema field changedOct 24, 2026

addedOutput schema / properties / related_documents

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "items": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "applicability": {
+            "const": "not_assessed",
+            "type": "string"
+          },
+          "doc_sha256": {
+            "pattern": "^[0-9a-f]{64}$",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "reference_design",
+              "user_guide"
+            ],
+            "type": "string"
+          },
+          "link_basis": {
+            "const": "exact_part_number",
+            "type": "string"
+          },
+          "next_steps": {
+            "additionalProperties": false,
+            "properties": {
+              "map_request": {
+                "additionalProperties": false,
+                "properties": {
+                  "doc_sha256": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "doc_sha256"
+                ],
+                "type": "object"
+              },
+              "page_text_request": {
+                "additionalProperties": false,
+                "properties": {
+                  "doc_sha256": {
+                    "type": "string"
+                  },
+                  "page": {
+                    "const": 1,
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "doc_sha256",
+                  "page"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "map_request",
+              "page_text_request"
+            ],
+            "type": "object"
+          },
+          "pages": {
+            "maximum": 9007199254740991,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "part_maker": {
+            "type": "string"
+          },
+          "publisher": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "doc_sha256",
+          "kind",
+          "title",
+          "publisher",
+          "part_maker",
+          "link_basis",
+          "applicability",
+          "next_steps"
+        ],
+        "type": "object"
+      },
+      "maxItems": 3,
+      "minItems": 1,
+      "type": "array"
+    },
+    "more": {
+      "maximum": 9007199254740991,
+      "minimum": 1,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "items"
+  ],
+  "type": "object"
+}

First observedOct 10, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Annotations already mark this read-only and idempotent, and the description adds substantial context beyond them: circuits are metadata only and not transcribed, the figure itself holds values and wiring, a printed part number does not prove design suitability, candidate_circuits are unreviewed with unverified page/manufacturer labels and no connections, and nothing is an electrical-fitness guarantee.

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?

Purpose is front-loaded and every clause carries real information (limitations, output semantics). However it is a long, densely punctuated run-on with nested parentheticals, which makes it harder to parse than necessary.

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?

Despite an output schema existing, the description usefully characterizes each returned list and their reliability. Combined with the brand-required and part_id-preferred guidance, an agent has everything needed to call and interpret it correctly.

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 coverage is 50%: brand and part_id are documented in the schema, and part_id's 'supplies brand + mpn' role is reinforced. The description adds 'manufacturer required' but says nothing about mpn or the limit bound, so it only partially compensates for the undocumented parameters.

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?

States a specific verb and resource: it locates where a manufacturer's datasheet prints application/example circuits for a part. It also enumerates what the response returns (datasheet_circuit_locations, related_documents, circuits, candidate_circuits), so an agent can distinguish it from siblings like get_figure_data or get_datasheet_map.

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?

Gives a clear prerequisite ('manufacturer required') and states scope exclusions ('Recipes and board-design records from our collection are not included'). It also tells the agent which output lists to trust ('circuits and candidate_circuits ... usually empty') and that figure content must be fetched via page-image/figure-data requests, but it never names an alternative sibling to use instead.

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

All PartsPlan tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?