Tekko BDSimSimulator

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

What can I ask?

1. Get the connector

Download local 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.mjs

The 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.

  1. Open a circuit → Build with AI → Have your own MCP server? (Advanced).
  2. Enter the Streamable HTTP URL and a token only if needed. Choose a tool and fill in its fields.
  3. 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

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.

Open the simulator · Browse circuit examples