Arduino simulator MCP setup — Tekko Sim
Ask your AI to blink an Arduino LED. With the connector installed, it can build a circuit, run code and inspect errors in Tekko Sim. Ask someone experienced to help with the first setup.
Start with the basics
- Circuit: parts connected by wires, such as a battery, switch and light.
- Simulator: a place to try a circuit on screen before building it.
- AI: software you can ask for help, such as Claude or Codex.
- MCP: the connection standard that lets your AI use simulator tools. MCP is not an AI model. Talk to your own AI app; this page has no chat.
What can I ask?
- Learning: “Make a light blink and explain what each part does.”
- No coding experience: “Build a switch-controlled light, one step at a time.”
- Developers: “Read the compiler error and serial output, make the smallest fix and run again.”
1. Get the connector
Extract the ZIP. Install Node.js 20 or newer. Open a terminal inside the extracted tekko-connector/mcp-src folder and run these commands one at a time.
npm ci
npx playwright install chromium
node setup.mjsThe first two commands download dependencies and Chromium. The last prints settings with the correct paths for your computer. This setup helper does not need an AI API key.
2. Connect your AI app
Copy the settings from node setup.mjs into your app’s MCP settings. The command is the Node executable and the argument is the full path to server.mjs. Claude Desktop uses the printed JSON; Codex uses the printed TOML. Save, then restart or reconnect MCP.
Other clients need local stdio MCP support. Cloud-only clients cannot reach this local connector. Review permission requests in your AI app. The first Tekko tool call opens a separate browser window; it does not attach to your existing tabs or accounts.
3. Try a small circuit
Use Tekko Sim. Start a new circuit, add an Arduino Uno and blink its built-in LED. Run it, read the diagnostics and explain the result simply.
Tools discover supported parts and exact pin IDs, add/move/remove parts, connect wires, change properties and code, run/stop, read serial and diagnostics, change virtual inputs and undo/redo. Arduino C++ and MicroPython use existing simulator language support; unsupported libraries remain unsupported.
Save your work
The AI browser session is temporary. Before closing it, ask for tekko_get_project_link and save the link. Opening it restores the circuit in your ordinary browser. Anyone with that link can read the circuit and code; no cloud document is created. For large circuits, save the JSON returned by tekko_get_project. Export before starting another circuit; saving inside the temporary session is not permanent.
Use your own MCP server (Advanced)
This section is not needed to let AI build circuits. Use it only if you have another MCP server. Server URL is its endpoint; Access token is its secret key, needed only when required by that server.
- Open a circuit → Build with AI → Have your own MCP server? (Advanced).
- Enter the Streamable HTTP URL and a token only if needed. Choose a tool and fill in its fields.
- Review what will be sent, then choose Run tool. Tools do not run automatically.
The browser connects directly to your server. It must allow CORS for https://tekko.teamzlab.com, including Authorization and MCP headers where needed. Browser local-network permissions may block access. Public and bearer-token servers are supported; OAuth-only servers and stdio commands need a compatible desktop MCP client. Complex tool fields may require JSON.
Closing the panel disconnects it. URL/token are not stored in browser storage; this feature is disabled on shared lab PCs. Results display as plain text and never run code or change the circuit automatically. External tools can have their own side effects; read their descriptions first.
Troubleshooting
- No browser: check Node, Chromium installation and the full server path. It opens on the first tool call.
- Missing part: ask for
tekko_list_parts; do not guess pin IDs. For code errors, inspecttekko_status, fix and rerun. - Connection failure: check endpoint, token, transport and CORS. A website URL is not an MCP endpoint. A timed-out action may have completed remotely; check before retrying.
- To stop AI control, disconnect Tekko in your AI app. Closing the browser ends the working window; restart the connector for a fresh session.
Costs and limits
Your computer runs the circuit; there is no Tekko-hosted inference or simulation relay. Initial downloads need internet. Your AI or external MCP service may charge separately. No shop, payment, admin or cloud-publishing tools are exposed.
The local connector needs one-time setup on a desktop computer; phone-only setup is not supported. The simulator works without AI. AI can be wrong, and a working simulation does not prove physical wiring is safe.
Real device and offline guide — The separate device bridge keeps reading-sharing and each command under your control.