MCP Support
The Model Context Protocol (MCP) is an open standard that allows AI agents—such as Copilot, Claude Code, Cursor, Gemini, ChatGPT and others to securely interact with external tools and services. For Wokwi users, MCP enables seamless integration between AI assistants and embedded simulation.
Wokwi MCP Server
The Wokwi CLI includes an experimental MCP server that allows AI agents to interact with Wokwi's simulation and testing capabilities. This enables AI agents to:
- Simulate complex embedded systems
- Run automated tests on embedded projects
- Monitor the serial console output and logs
- Interact with the virtual hardware in real-time
The MCP server gives the agent the tools. To also teach it how to test firmware with Wokwi, for example how to find a memory leak or test a display UI, install the Wokwi agent skills. The skills work with or without the MCP server.
Configuration
To configure your AI agent to use the Wokwi MCP server, add the following to your agent's MCP configuration:
{
"servers": {
"Wokwi": {
"type": "stdio",
"command": "wokwi-cli",
"args": ["mcp"],
"env": {
"WOKWI_CLI_TOKEN": "${input:wokwi-cli-token}"
}
}
}
}
Authentication
You will need a valid Wokwi CLI token to use the MCP server. You can generate a token in the Wokwi CI Dashboard.