PCBBrew for your AI agent
Design real printed circuit boards from Claude Code, Cursor, Codex or any MCP client. Your agent and your model make the engineering decisions; PCBBrew does the heavy lifting with KiCad: schematic, placement, routing, design-rule checks, circuit simulation, firmware compilation and manufacturing files.
Get an API keyHow it works
https://pcbbrew.dev/mcp/agent to your agent with the key.Connect
No key needed: you sign in to PCBBrew and allow access. Claude (claude.ai, desktop, mobile): Settings → Connectors → Add custom connector ChatGPT: Settings → Apps → Advanced → Developer mode → Create app URL: https://pcbbrew.dev/mcp/agent Then "Connect": a PCBBrew page opens, sign in and press Allow. Without signing in you can already search the catalogue, the KiCad libraries and the design guide; creating and building projects asks you to sign in.
claude mcp add --transport http pcbbrew-agent https://pcbbrew.dev/mcp/agent \ --header "Authorization: Bearer $PCBBREW_API_KEY"
// ~/.cursor/mcp.json
{ "mcpServers": { "pcbbrew-agent": {
"url": "https://pcbbrew.dev/mcp/agent",
"headers": { "Authorization": "Bearer ${env:PCBBREW_API_KEY}" } } } }
# ~/.codex/config.toml [mcp_servers.pcbbrew-agent] url = "https://pcbbrew.dev/mcp/agent" bearer_token_env_var = "PCBBREW_API_KEY"
// .vscode/mcp.json
{ "servers": { "pcbbrew-agent": { "type": "http",
"url": "https://pcbbrew.dev/mcp/agent",
"headers": { "Authorization": "Bearer ${input:pcbbrew-key}" } } },
"inputs": [ { "id": "pcbbrew-key", "type": "promptString", "password": true,
"description": "PCBBrew API key" } ] }
Integrations → MCP Servers for Replit Agent → + Add MCP server Name: PCBBrew Agent URL: https://pcbbrew.dev/mcp/agent Advanced settings → header Authorization: Bearer pcbb_…
Streamable HTTP MCP server URL: https://pcbbrew.dev/mcp/agent Header: Authorization: Bearer pcbb_…
One click: after creating a key in your account, use its “Add to Cursor” and “Add to Replit” buttons: the key is filled in for you.
Keep the key in an environment variable or your client's secret store, never in a shared file or a chat. You can revoke it any time from your account.
Tools
| Tool | What it does |
|---|---|
get_guide | Workflow, design format and design rules: the agent reads it first. |
create_project · list_projects · get_project | Projects in your account and their state. |
search_catalog · catalog_part | Microcontroller boards and modules PCBBrew can place and simulate. |
search_library · part_info | KiCad symbols and footprints, with pins and pads to check against each other. |
set_requirements · set_design | Requirements and the full circuit, validated: ERC, part ratings, pin mapping, power and interface checks. |
generate_schematic | KiCad schematic, verified against KiCad's netlist. |
place_pcb · route_pcb | Automatic placement on the smallest board, autorouting on 2–6 layers, ground planes and DRC. |
simulate_circuit | ngspice simulation with virtual scope and meters, and pass/fail checks. |
set_firmware · test_firmware | Arduino compilation and a run in the microcontroller emulator. |
write_documentation · export_files · get_files | Project PDF, Gerber, drill, BOM, pick-and-place, KiCad files and STEP. |
wait_job | Routing and compiling take minutes: the agent waits for the result. |
Credits
PCBBrew does not run an AI model for these calls: you use your own. Searches, design checks and the schematic are free; the compute-heavy steps use a few credits from your account.
| Step | Credits |
|---|---|
| Placement · simulation · firmware test | 1 |
| Export of manufacturing files | 2 |
| Firmware compilation | 3 |
| Routing with DRC and 3D | 5 |
A typical board uses about 10–20 credits. Free accounts start with 100 credits.
Good to know
- Circuits up to 30 V: no mains voltage.
- Manufacturing files are released only when every connection is routed and the design-rule check is clean.
- One heavy tool at a time per account; long tools answer “running” and the agent calls
wait_job. - Projects follow your plan's rules (visibility, limits), exactly like the ones made in the app.
- Review the design before ordering boards: the checks help, they don't replace an engineer.
Support
Write to [email protected]. Privacy policy · Terms