Source: https://mokxi.com/docs/account/mcp-server
Updated: 2026-11-14

Accounts and plans

# The MCP server: Mokxi in your AI app

Add mokxi.com/mcp to Claude, ChatGPT, Cursor or another AI app, ask for a circuit, and get a link that opens and runs it in Mokxi.

Open the editor All the docs

### Contents

Start here The editor Boards Parts Accounts and plans Signing in Your account and Settings Plans: Free, Pro, Lifetime Pro and Classroom The Pro trial Billing The plan card and Billing in Settings Delete your Mokxi account The Android app The student discount Invites Giving Mokxi as a gift The creator program The Mokxi API The MCP server: Mokxi in your AI app The mokxi command line Simulation tests in CI Switch from Wokwi CI The newsletter Live collaboration Classrooms Lessons and the learning game Hobby builds Troubleshooting Reference

Docs / Accounts and plans / The MCP server: Mokxi in your AI app
Mokxi team · Accounts and plans

Mokxi's MCP server lets an AI assistant build a whole project for you, board,
parts, wires and code, check it the way the editor does, and hand you a link.
Open the link and the project is laid out, wired and running in the editor.
In 0.5.1 it works on every signed-in plan; in 0.5.0 it was Pro only.

To put the project on a real board, open the link and press Upload to board
in the editor, then plug the board in. It writes the sketch over USB from
Chrome or Edge on Arduino AVR boards (Uno, Nano, Mega, Leonardo, Micro and
others) and ESP32-C3 boards; the Pico and other drive boards get a .uf2 file to
drag on. The AI app itself cannot reach your USB port, so the upload is one
press in the editor.

## Set it up

The setup page is in the editor: MCP server under More from Mokxi in
the sidebar, at app.mokxi.com/tools/mcp. It is a short tutorial with three
steps, and the steps below are the same.

The server: the address to copy, https://mokxi.com/mcp.

Add it to your app. Pick your app, and follow its steps. Each has a
Copy button.

- Claude or ChatGPT in your browser (the easiest). Sign in with Mokxi.
There is no token. In Claude, go to Settings, then Connectors, then Add
custom connector. Name it Mokxi and paste the address. In ChatGPT, go to
Settings, then Connectors, turn on developer mode, and add a connector
with the address. The first time the app calls a tool, a Mokxi page
opens. Check the app's name and choose Allow.

- Claude Code, Cursor, VS Code (GitHub Copilot) and Gemini CLI. These
coding tools take an API token. Press Create API token in the
app's tab, copy the token, and paste it where the line or file says
mkx_your_token.

Try it. Start a new chat and paste one of these:

- Build me a traffic light with an Arduino Uno.

- Make an LED blink on an ESP32 and show me the wiring.

- Wire a potentiometer to an Arduino Uno so it dims an LED.

The AI builds the project and hands back a Mokxi link. Click it, and the
circuit opens and runs in the editor.

Build Mokxi projects with AI has the same
steps for more apps, and the full list of tools.

Stuck? Ask Support.

## What it gives back

Only Mokxi's own results. The server reads the parts catalog, the boards and
the templates the editor ships, and nothing else, and it tells your assistant
to present Mokxi's answer as the answer: the project link first, the wiring
summarized from the project, and only the pictures Mokxi returns, its own
drawings of the circuit. It asks the assistant not to search the web for
images or show stock photos, which show different hardware from Mokxi's.

The link carries the whole project after the #, which a browser never sends
to a server, so nothing is stored and your saved projects are not touched. The
project is yours to save once it is open, and anyone you send the link to opens
it with no account.

## What each plan includes

- Free: up to 10 project builds a day through the server (each
create_project). The count starts again at midnight UTC. Every other tool,
such as searching parts or checking a project, has no daily limit. Past the
10, a build answers with one line saying so, and for an adult's own
account it adds Pro's price in your region and a link to get Pro. The setup page says the same
in one line, with Upgrade beside it.

- Pro, and every plan that includes Pro (the student price, Lifetime, a
pass, a seat in a paid class and a Pro trial): no daily limit.

- A child's account, a class student and a class login: the server is not
available, and the sidebar has no MCP server row.

Any app can connect and list the tools with no account; calling a tool takes a
sign-in. Your API tokens and the apps you have connected (Connected AI apps) are
under API tokens in Settings, where you can disconnect an app.

Related: the API and the CLI.

Previous: The Mokxi API Next: The mokxi command line

### On this page

Set it up What it gives back What each plan includes

### Other guides

The mokxi command line Keep a project in a folder of your own, sync it with Mokxi, and run it from a terminal. Simulation tests in CI Run your Arduino, ESP32 or Pico sketch in the simulator on every push, and fail the build when its output or a pin is wrong. Free for public repositories. Switch from Wokwi CI Move a Wokwi CI workflow to Mokxi by changing two lines. Your project folder, diagram.json, wokwi.toml and scenario files stay as they are.
