Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CIRCUITARIUM_JAVANoThe Java command to use (must be Java 21+).java
CIRCUITARIUM_MCP_ROOTYesThe absolute path to the circuit workspace folder.
CIRCUITARIUM_LOGISIM_JARNoAbsolute path to the Logisim-evolution 4.1.0 all-JAR file.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
review-circuit-designUse the correct adapter evidence path to review one CRUMB or Logisim design.
compare-crumb-designsCompare a Unity-era CRUMB baseline and candidate without writing either artifact.
verify-logisim-designBuild an evidence-graded Logisim-evolution 4.1.0 verification workflow.
handoff-circuit-projectPrepare a model-neutral handoff with immutable artifact identity and evidence limits.

Resources

Contextual data attached and managed by the client

NameDescription
circuitarium-capabilitiesStatic, model-neutral vocabulary and workflow guidance. Call electronics_capabilities for live runtime availability.
crumb-unity-profileVersion-pinned interpretation evidence and limitations for Unity-era CRUMB saves.
logisim-evolution-profileStatic and configured-JAR evidence boundaries for the Logisim-evolution adapter.
crumb-component-catalogBounded component schemas, IC package observations, and evidence meanings without CRUMB assets.
synthetic-example-catalogRedistributable CRUMBLE fixture kinds and the independently authored Logisim full-adder example.
electrical-review-guideA simulator-neutral checklist for reviewing breadboard and digital designs without overstating static evidence.
digital-logic-testing-guideReusable combinational and sequential test strategies for neutral projects and Logisim-evolution.
neutral-component-profile-schemaStrict JSON Schema plus curated, source-cited component profiles for planning across simulator adapters.
logisim-evolution-standard-library-catalogCommit-pinned inventory of all 14 built-in libraries and 169 project component identities, with runtime-policy and semantic-coverage boundaries.

Latest Blog Posts

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