circuitarium-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CIRCUITARIUM_JAVA | No | The Java command to use (must be Java 21+). | java |
| CIRCUITARIUM_MCP_ROOT | Yes | The absolute path to the circuit workspace folder. | |
| CIRCUITARIUM_LOGISIM_JAR | No | Absolute path to the Logisim-evolution 4.1.0 all-JAR file. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| electronics_capabilitiesA | Zero-argument onboarding for model-neutral conventions, callable backends, truthful limitations, and recommended workflows. Call this first when unsure. |
| electronics_validate_experimentA | Checks an arbitrary JSON value against the simulator-neutral circuit, firmware, probe, assertion, and timing contract. Invalid input returns ok=true and data.valid=false with diagnostics. |
| electronics_plan_verificationA | Builds a deterministic, simulator-neutral plan for explicit claims using bounded caller-reported evidence. It reads no files, runs no tools or simulators, authenticates no receipts, and never certifies physical hardware. |
| crumb_component_catalogA | Returns the version-pinned CRUMB tool-ID catalog, payload signatures, typed parameters, terminal labels, confidence values, and their machine-readable evidence vocabulary. Optionally filter by toolId. |
| crumb_analyze_designA | Recognizes version-pinned component parameters, terminal attachments, and inferred connection groups. Summary is the bounded default; components and connections use opaque cursors. Embedded firmware and geometry require explicit opt-in. |
| crumb_compare_designsA | Read-only, GUID-matched comparison of a baseline and candidate .cru under crumb.unity/1.3.5. Distinguishes exact bytes, modeled equivalence, root changes, component changes, and unverified payload signatures without returning raw XML, firmware, EEPROM bytes, or thumbnails. |
| crumb_inspect_designA | Returns a bounded save summary and tool-ID counts. Use crumb_analyze_design for paginated semantic component and connection details. |
| crumb_validate_designA | Performs XML and CRUMB structural checks without launching the game. A bad design returns ok=true and data.valid=false. |
| crumb_generate_fixtureA | Creates one known fixture without overwriting. Provide outputPath for a file artifact; raw XML is returned only when includeXml=true. |
| crumb_list_projectsA | Enumerates .cru files under the workspace root (or one subdirectory) with size, modification time, and SHA-256 digest, so a model can discover projects without being handed a path. |
| crumb_get_componentA | Returns a single component by id with parameters, terminals, geometry, its inferred connection groups, and windowed access to embedded firmware source past the analyze cap. The read-back companion for iterative work on one part. |
| crumb_bomA | Groups recognized components by kind and decoded part values into quantities. State values such as switch positions are excluded from part identity; unknown and schema-mismatched components stay visible as their own lines. |
| crumb_ic_referenceA | Queries the version-pinned tool-5 IC registry by prefabId or by a label/package substring (for example "74HC138"). Returns package labels, ordered pin names, and explicit unresolved pins. |
| crumb_export_netlistA | Collapses jumper wires out of the inferred connection graph and returns paged electrical nets with component terminals, VCC/GND names inferred from DC supply terminals, and optional saved-switch-state merges. Provenance and confidence are explicit. |
| crumb_trace_netA | Selects one component terminal by stable index and returns a paged deterministic connectivity witness with structured attachment, board, jumper, and optional saved-switch provenance. It is static conductive inference, not current flow, path enumeration, or simulation. |
| crumb_check_designA | Lints the inferred netlist: supply shorts, LEDs directly across the rails, shorted two-terminal parts, floating IC power pins, resistor power ratings, and floating terminals. Findings carry evidence confidence and rule basis; a rule violation returns ok=true with data.valid=false. |
| logisim_list_projectsA | Discovers workspace .circ projects with stable raw-byte digests. This is static file discovery and does not launch Logisim. |
| logisim_analyze_designA | Parses bounded .circ XML into project, circuit, pin, clock, component, and explicit conversion-loss summaries. Static parsing is not simulation evidence. |
| logisim_export_netlistA | Exports simulator-neutral coordinate-endpoint nets with explicit loss markers. It does not infer unmodeled gate geometry, mid-segment junctions, or behavior. |
| logisim_component_statsB | Invokes the separately installed JAR, after it self-reports Logisim-evolution 4.1.0, with --tty stats. Success proves that configured process loaded the staged project, not behavioral simulation or binary authenticity. |
| logisim_truth_tableC | Invokes the separately installed JAR, after it self-reports Logisim-evolution 4.1.0, in CSV/binary table mode after statically bounding declared input width. |
| logisim_run_test_vectorB | Invokes the separately installed JAR, after it self-reports Logisim-evolution 4.1.0, with staged snapshots of a workspace-contained project and .vec/.txt file. Assertion failures return ok=true with data.valid=false. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| review-circuit-design | Use the correct adapter evidence path to review one CRUMB or Logisim design. |
| compare-crumb-designs | Compare a Unity-era CRUMB baseline and candidate without writing either artifact. |
| verify-logisim-design | Build an evidence-graded Logisim-evolution 4.1.0 verification workflow. |
| handoff-circuit-project | Prepare a model-neutral handoff with immutable artifact identity and evidence limits. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| circuitarium-capabilities | Static, model-neutral vocabulary and workflow guidance. Call electronics_capabilities for live runtime availability. |
| crumb-unity-profile | Version-pinned interpretation evidence and limitations for Unity-era CRUMB saves. |
| logisim-evolution-profile | Static and configured-JAR evidence boundaries for the Logisim-evolution adapter. |
| crumb-component-catalog | Bounded component schemas, IC package observations, and evidence meanings without CRUMB assets. |
| synthetic-example-catalog | Redistributable CRUMBLE fixture kinds and the independently authored Logisim full-adder example. |
| electrical-review-guide | A simulator-neutral checklist for reviewing breadboard and digital designs without overstating static evidence. |
| digital-logic-testing-guide | Reusable combinational and sequential test strategies for neutral projects and Logisim-evolution. |
| neutral-component-profile-schema | Strict JSON Schema plus curated, source-cited component profiles for planning across simulator adapters. |
| logisim-evolution-standard-library-catalog | Commit-pinned inventory of all 14 built-in libraries and 169 project component identities, with runtime-policy and semantic-coverage boundaries. |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Craftiee/circuitarium-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server