Server data from the Official MCP Registry
Builds and simulates Arduino breadboard circuits in Tinkercad Circuits.
About
Builds and simulates Arduino breadboard circuits in Tinkercad Circuits.
Security Report
The server is a Playwright-driven automation bridge that edits Tinkercad Circuits designs through the editor's internal JavaScript model. It validates design URLs to tinkercad.com, validates inputs with zod, and has no hardcoded secrets, shell execution, or data exfiltration paths in the reviewed code. The main concerns are that it relies on undocumented editor internals, stores a persistent logged-in browser profile on disk, and the truncated spec.ts could not be fully reviewed. Supply chain analysis found 6 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.
8 files analyzed · 12 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"tinkercad-circuits-mcp": {
"command": "npx",
"args": [
"-y",
"tinkercad-circuits-mcp@0.1.0"
]
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
tinkercad-circuits-mcp
An MCP server that builds Arduino circuits in Tinkercad Circuits and runs them in the simulator. You describe the circuit (which part goes in which breadboard hole, the wires, the sketch) and it appears in your Tinkercad account, wired on a breadboard, with the code saved. It can then start the simulation, press buttons, type into the Serial Monitor and tell you what the LEDs, servos and serial output did.
It works with Claude Code, Claude Desktop, Cursor, Codex and any other client that speaks the Model Context Protocol.

examples/traffic-light.json, built and simulated by the server. The LEDs are read back from the simulator to check the order.
I wrote it to get through a course with 70-odd Arduino lab tasks that all had to be handed in as Tinkercad designs. Building them by hand took forever.
If you found sethski/tinkercad-mcp-server first: that one works by clicking and dragging in the editor. When I tried it in November 2026 it could not create a circuit or find the breadboard in the parts panel, and it had no way of knowing which hole a leg ended up in. This server changes the editor's circuit model directly, so parts land in the holes you name, and it reads the result back and checks it in the simulator.
Not affiliated with Autodesk. Tinkercad has no public API for Circuits; this uses the editor's internals, which can change without notice. See How it works.
What it can do
- Create or open a design and build a whole circuit in one call: Arduino Uno, small breadboard, parts in the holes you name, colour-coded jumper wires routed around the board.
- Write the Arduino sketch into the design.
- Read a design back: every part, the hole under each pin, its settings, every wire, the code.
- Run the simulator and sample LED brightness, servo angles and the Serial Monitor at the times you choose, while pressing buttons or sending serial input.
- Change a setting between runs, like a potentiometer position or the distance an ultrasonic sensor sees, to test different inputs.
About 20 parts are supported: LEDs, resistors, buttons, potentiometers, servos, a piezo, the HC-SR04, TMP36, DC motors (with and without encoder), the L293D, an IR receiver, an RGB LED and a few more. The full list is in docs/parts.md.
Setup
You need Node.js 20 or newer and Google Chrome.
Claude Code
Install it as a plugin. That adds the MCP server and the skill in one go:
/plugin install tinkercad-circuits --marketplace netchuu/tinkercad-circuits-mcp
From a shell: claude plugin marketplace add netchuu/tinkercad-circuits-mcp and then claude plugin install tinkercad-circuits@tinkercad-circuits-mcp.
If you only want the server: claude mcp add tinkercad-circuits -- npx -y tinkercad-circuits-mcp.
Codex
In ~/.codex/config.toml:
[mcp_servers.tinkercad-circuits]
command = "npx"
args = ["-y", "tinkercad-circuits-mcp"]
and the skill:
mkdir -p ~/.codex/skills/tinkercad-circuits
curl -fsSL https://raw.githubusercontent.com/netchuu/tinkercad-circuits-mcp/main/skills/tinkercad-circuits/SKILL.md -o ~/.codex/skills/tinkercad-circuits/SKILL.md
Claude Desktop, Cursor and other clients
Add this to the client's MCP config: claude_desktop_config.json for Claude Desktop, ~/.cursor/mcp.json for Cursor.
{
"mcpServers": {
"tinkercad-circuits": {
"command": "npx",
"args": ["-y", "tinkercad-circuits-mcp"]
}
}
}
Sign in to Tinkercad
Once, whichever client you use:
npx -y tinkercad-circuits-mcp login
This opens Chrome on the Tinkercad page. Sign in the way you normally do; it is an ordinary Chrome window. It closes once you reach your dashboard. The session lives in ~/.tinkercad-circuits-mcp/profile; your password never passes through this project.
Restart your client afterwards so it picks up the server.
Let your agent set it up
You can hand the setup to Claude Code or Codex:
Set up the Tinkercad Circuits MCP server from https://github.com/netchuu/tinkercad-circuits-mcp, following its README.
The agent can do everything except signing in. It should run npx -y tinkercad-circuits-mcp login and ask you to sign in in the Chrome window that opens; then, after a restart, tinkercad_status should report signedIn: true.
From source
git clone https://github.com/netchuu/tinkercad-circuits-mcp.git
cd tinkercad-circuits-mcp
npm install
npm run build
npm run login
and use node /full/path/to/tinkercad-circuits-mcp/dist/index.js as the command in the configs above.
Using it
Ask for a circuit in plain words:
Build a traffic light in Tinkercad: red, yellow and green LEDs on pins 10, 9 and 8, green for 5 s, yellow 2 s, red 5 s. Then run it and check the order.
Claude turns that into a spec for tinkercad_build_circuit. A smaller one, a single blinking LED, looks like this:
{
"title": "Blink an LED on a breadboard",
"parts": [
{ "ref": "r1", "type": "resistor", "at": "5g", "pin": "1", "angle": 90, "props": { "ohms": 220 } },
{ "ref": "led1", "type": "led", "at": "9i", "pin": "anode", "angle": 180 }
],
"wires": [["uno.GND1", "T-1"], ["uno.D13", "5i"], ["10h", "T-10"]],
"code": "void setup() { pinMode(13, OUTPUT); }\nvoid loop() { digitalWrite(13, HIGH); delay(1000); digitalWrite(13, LOW); delay(1000); }"
}
The resistor spans columns 5 to 9 in row g, the LED's anode shares column 9 and its cathode goes to the ground rail. The format is explained in docs/circuit-spec.md, and there are more complete circuits in examples/.
To check the circuit, Claude calls tinkercad_simulate:
{ "samples_ms": [500, 1500, 2500], "leds": ["led1"] }
and gets back, for each sample, whether led1 was on and the simulator clock at that moment.
Tools
| Tool | What it does |
|---|---|
tinkercad_status | Checks that the Chrome profile is signed in to Tinkercad. |
tinkercad_list_parts | Parts, pin names and settings. |
tinkercad_open_circuit | Opens a design by link or id, or creates a new one. |
tinkercad_build_circuit | Replaces the open circuit with the one in the spec and saves the code. |
tinkercad_get_circuit | Reads the saved circuit back. |
tinkercad_set_code | Replaces the sketch. |
tinkercad_set_part | Changes a part setting (knob position, sensor distance). |
tinkercad_simulate | Runs the simulator with button presses and serial input; returns LED, servo and serial readings. |
tinkercad_screenshot | Returns a picture of the editor. |
Limits
- One small breadboard per circuit, Arduino Uno only.
- Tinkercad has no KY-023 joystick, LM35, HC-05 Bluetooth module, L298N or IR line sensor. The skill lists the usual stand-ins (two potentiometers, TMP36, the Serial Monitor, L293D, pushbuttons).
- The simulator runs slower than real time, and LED readings come from a screenshot, so leave some margin in your timings. Hold buttons for at least 0.6 s.
- Only one process can use the Chrome profile at a time.
- If Tinkercad changes its editor internals, building will fail until the code is updated.
npm run smoketells you quickly whether it still works.
Documentation
- Circuit spec: holes, rails, parts, wires, settings
- Simulation: timelines, reading LEDs, servos and serial, testing a task
- How it works: the Tinkercad internals this relies on
- Parts: every supported part with its pins
- Troubleshooting
Development
npm test # unit tests for the spec and catalog, no browser needed
npm run smoke # builds and simulates two circuits in your Tinkercad account
npm run parts-doc # regenerates docs/parts.md
The smoke test creates a design called "tinkercad-circuits-mcp smoke test". Pass its link to reuse it: npm run smoke -- https://www.tinkercad.com/things/<id>.
Issues and pull requests are welcome, especially new parts. Adding one is mostly finding its device id (the data-did attribute on the tile in Tinkercad's parts panel) and its pin names; How it works has the details.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
