{"id":"ai.koppar/koppar","slug":"ai-koppar-koppar","title":"Koppar","description":"Design a KiCad PCB from a prompt: parts, schematic checks, routing, KiCad DRC and Gerbers.","version":"1.0.1","publisher":{"kind":"domain","id":"koppar.ai","label":"koppar.ai","url":"https://koppar.ai"},"website":"https://docs.koppar.ai/agents/mcp","repository":"","remotes":[{"type":"streamable-http","url":"https://app.koppar.ai/mcp","headers":[{"description":"Bearer sc_… key from Settings → Design from your own AI agent at app.koppar.ai (free sign-up)","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-17","updated":"2026-10-17","status":"online","auth":"","latency_ms":1245,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_workflow_guide","title":"Workflow guide","description":"How to drive Koppar end to end, and the instructions for each stage you do yourself: \"research\" (part research and the dossier), \"synthesis\" (writing the SKiDL schematic), \"review\" (design review), \"board\" (the board plan). Read the stage guide before doing that stage.","read_only":true},{"name":"create_design","title":"Create a design","description":"Start a new design from the user's brief (what the board must do, its interfaces, power, size and constraints). Returns the design_id every other tool takes and the web_url where the user follows the design. Uses no generation quota: the work is done by you.","read_only":false},{"name":"leave_feedback","title":"Leave feedback","description":"Send the Koppar team feedback from the user: about Koppar in general, or about one design (design_id). A rating from 1 to 5, a message, or both. Use it when the user asks you to pass something on, or tells you what worked or did not; say in the message what happened, in their words where you can. The team reads every one.","read_only":false},{"name":"list_designs","title":"List designs","description":"The user's designs, newest first, including ones made in the web app (an agent can continue those too) and board workspaces (kind \"board workspace\"). With trashed, the designs in the trash instead.","read_only":true},{"name":"delete_design","title":"Delete a design","description":"Move a design (or a board workspace) to the trash: it leaves list_designs and the web app, and restore_design brings it back. permanent deletes it with no trash to restore from. Refused while a run on it is in progress. The CLI: `koppar delete <design>`.","read_only":false},{"name":"restore_design","title":"Restore a design from the trash","description":"Put a deleted design back from the trash.","read_only":false},{"name":"get_design","title":"Design status","description":"Where a design stands: the brief, the schematic (accepted or the last blocking error, ERC, part and net counts, submissions), the board run, the readable files, and the next step.","read_only":true},{"name":"search_kicad_symbol","title":"Search KiCad symbols","description":"Search KiCad's standard symbol libraries for parts whose name contains a substring. Use this whenever you are not 100% sure the (library, name) pair you're about to pass to Part(...) exists. Always prefer the package-suffixed variant the search returns over a generic name. If a part returns nothing here, get_kicad_symbol(library='custom', name='<part number>') may find it in the component database","read_only":true},{"name":"get_kicad_symbol","title":"Get a KiCad symbol","description":"Return the full pin list (number, name, electrical type) and description for a specific KiCad symbol. For some high-risk power parts it also returns curated topology_constraints from datasheet-style application notes and footprint_suggestions. Use this before writing pin connections (e.g. mcu['VCC'] += vcc) so names, constraints and footprints match the symbol exactly. For a part found in KiCad, t","read_only":true},{"name":"search_kicad_footprint","title":"Search KiCad footprints","description":"Search KiCad's standard footprint libraries. Returns 'Library:Footprint' strings suitable for the footprint= argument of Part(...). Query with the package family and pin count ('LGA-14', 'QFN-24', 'SOIC-8'), optionally a body size or pitch. When no name contains every word, near_misses lists footprints of the same package, ranked by body size and pitch. Pass design_id so the lookup is recorded for","read_only":true},{"name":"create_custom_symbol","title":"Register a custom symbol","description":"Register a connectable schematic symbol for a part that is NOT in KiCad's libraries (search_kicad_symbol returned nothing). Use this for specialty ICs — LED-matrix drivers, niche sensors, etc. — INSTEAD of telling the synthesizer to model the part with discrete passives (which leaves every pin dangling and breaks the board). Provide the full datasheet pinout. The part then becomes available to the","read_only":false},{"name":"add_custom_footprint","title":"Add your own footprint","description":"Give the design a footprint of your own: a KiCad .kicad_mod (the file's text) for a package KiCad's libraries lack. It joins the design's \"custom\" footprint library and is used as \"custom:<name>\": pass that to create_custom_symbol (footprint=) or name it in the SKiDL script's footprint=; the board builder loads it like a library footprint and the KiCad project download carries it. The pads must be","read_only":false},{"name":"save_dossier","title":"Save the parts dossier","description":"Store the research dossier (markdown with ## Parts list, ## Power rails, ## Topology constraints, ## Notes, as the research guide describes). The verified pin tables from your lookups on this design are appended, and verified entries the design already had for parts you did not look up again are kept. Reports every (library, name) in the parts list that does not exist, with catalog candidates.","read_only":false},{"name":"submit_circuit","title":"Submit the schematic","description":"Compile and check a complete SKiDL script: the symbol and footprint pre-flight (unambiguous typos are corrected and listed), SKiDL, the ERC score, KiCad ERC, floating subsystems, parts without a footprint, and supplier sourcing. Returns accepted plus blocking findings to fix and warnings. An accepted script becomes the design's circuit.py; one that is sent back is kept as attempt_N_circuit.py and ","read_only":false},{"name":"edit_circuit","title":"Patch the schematic","description":"Apply SEARCH/REPLACE patches to your latest script and re-run every check, as submit_circuit does. The latest script is your last submission when it was sent back (attempt_N_circuit.py), otherwise the design's circuit.py. Each search must match the current file exactly once (whitespace-sensitive); an empty replace deletes. Nothing is applied if any block fails to match.","read_only":false},{"name":"read_design_file","title":"Read a design file","description":"Read a text file of the design: prompt.txt (brief), dossier.md, circuit.py, circuit.net, result.json, circuit.erc.json (KiCad ERC violations), attempt_N_circuit.py / attempt_N_error.txt, board_plan.json, pcb_result.json, pcb_run.log, circuit.drc.json (KiCad DRC), netclasses.resolved.json, dfm.json, harness.log.","read_only":true},{"name":"get_review_packet","title":"Design review packet","description":"Everything a design review needs in one text: the brief, the dossier, circuit.py and the compiled connectivity (every net with every pin and its function), with the reviewer instructions. Review it yourself and fix blockers with edit_circuit.","read_only":true},{"name":"get_board_context","title":"Board planning context","description":"What the board plan is decided from: the computed minimum board, BOARD STATS (pad density, fine-pitch parts, fanout), the parts and nets, board instructions the user gave, and the plan schema with its rules. Needs an accepted schematic.","read_only":true},{"name":"start_board","title":"Place and route the board","description":"Start place and route with your board plan (the JSON object from the board guide: board, stated, edge, chain, groups, near, side, fixed, keepouts, netClasses). The plan is clamped and returned as applied. Runs for minutes in the background: follow it with get_board_status. Needs an accepted schematic; one board run per design at a time.","read_only":false},{"name":"get_board_status","title":"Board status","description":"The board run: stage, size, layers, placement, routing completion, open nets, DRC counts; once finished, DRC violations by type, whether the fab files are released and, when not, the diagnosed causes (first = fix first: parts that did not fit, collisions, missing footprints, open nets, thin power). wait_s holds the call until the run ends (or that many seconds pass).","read_only":true},{"name":"get_bom","title":"Bill of materials","description":"The live-priced BOM: each line with references, value, footprint, the chosen offer (seller, part number, MPN, price, stock, match quality), alternatives and totals. refresh asks the sellers again (tens of seconds).","read_only":true},{"name":"choose_bom_part","title":"Choose a BOM offer","description":"Pick which offer a BOM line uses: the line's references and a seller part number or MPN from its offer or alternatives in get_bom; null goes back to the automatic pick. Sourcing only: a different component is a circuit change.","read_only":false},{"name":"consolidate_bom_basic","title":"Consolidate the BOM to JLCPCB basic parts","description":"Move every resistor, capacitor and inductor bought outside JLCPCB's basic library onto an in-stock basic-library part of the same value, package and (capacitors) at least the same voltage rating. Each part outside that library adds a loading fee to a JLCPCB order, usually more than the part. Each swap becomes the line's choice (choose_bom_part with null undoes it); lines with no readable value, no","read_only":false},{"name":"get_fab_status","title":"Fab release status","description":"Whether the board has earned its fab files (zero serious DRC errors, nothing unconnected), and if not, why not.","read_only":true},{"name":"list_order_providers","title":"Manufacturers","description":"The PCB and assembly providers, whether each can quote and take this kind of board today, and what a handoff sends them.","read_only":true},{"name":"get_order_price","title":"Order price","description":"One price for a quantity: parts from the sellers, the board and assembly from the chosen provider's quote, setup fees, and what the total does not include.","read_only":true},{"name":"send_order_to_provider","title":"Send the order to a manufacturer","description":"Upload the released board (Gerbers, BOM, placement) to a manufacturer and return the page where the user pays. This publishes the design to a third party: call it only when the user has explicitly asked to order from that provider, and set user_confirmed only then. Some providers need a shipping address.","read_only":false},{"name":"upload_board","title":"Upload a board","description":"Replace the design's board with a .kicad_pcb you routed or edited yourself (the file, base64). The board must carry the design's circuit: every schematic part by reference, every pad on the net the netlist gives it; a footprint swap is allowed and recorded. Anything else is refused with the list of differences and nothing changes. The previous board is kept as circuit.before-upload.kicad_pcb. KiCa","read_only":false},{"name":"get_downloads","title":"Downloads","description":"Download URLs for the design (KiCad project, schematic, netlist, BOM CSV, board file, 3D model, Gerbers, order bundle) and which are available now. They take the same Authorization: Bearer API key; the CLI fetches them with `koppar download <design> <artifact>`.","read_only":true},{"name":"import_kicad_project","title":"Import a KiCad project","description":"Bring an existing KiCad project in as a board workspace: the project folder as a ZIP (the .kicad_pcb, .kicad_pro, schematics, footprint and 3D-model folders), base64-encoded, up to about 18 MB zipped. An Altium Designer project (the .PcbDoc at the top of the ZIP) is converted with KiCad: the board, and its clearance, width, via and differential-pair rules as net classes; the reply lists the rules ","read_only":false},{"name":"get_board_info","title":"Board info","description":"The board as it stands: copper layers, outline, design rules and net classes, counts (footprints, nets, tracks, vias, zones, keepouts, KiCad unconnected items), zones and keepouts, and every footprint with reference, value, footprint, position (origin, mm), rotation, side, locked, DNP, courtyard box and 3D models.","read_only":true},{"name":"place_footprints","title":"Place footprints exactly","description":"Put footprints exactly where given: KiCad board coordinates of the footprint origin in mm (y grows downward), rotation in degrees as KiCad shows it, side F or B (changing side flips the footprint, as KiCad does), locked. dx_mm/dy_mm/drot_deg move relative to where it is. Nothing is nudged or legalized: overlaps are for run_drc to report. Unknown references come back in missing.","read_only":false},{"name":"auto_place","title":"Auto-place footprints","description":"Pack footprints inside the board outline with Koppar's heuristic placer (ratsnest-driven, courtyard-legal). By default every unlocked footprint moves and locked ones stay; refs names exactly which move (all others stay). Constraints: fixed (exact origin positions and rotation, never moved; locked footprints likewise), side, keepouts (rectangles), groups, near (ref within maxMm of an anchor), edge ","read_only":false},{"name":"anneal_place","title":"Anneal a dense placement","description":"Dense placement by simulated annealing: wirelength inside the real outline (Edge.Cuts with its corners, notches and cutouts; a separate piece no held part stands on is left out) with courtyard gaps, edge connectors held on their edge, fixed and locked parts held, and, unless refs is given, the mounting holes, connectors and switches already on the board held too (held_mechanical). Kept clear: keep","read_only":false},{"name":"set_board_outline","title":"Set the board outline","description":"Replace everything on Edge.Cuts with a new outline: rect (optionally with corner_radius_mm), a polygon of points, or fit_to_parts (the rectangle around every footprint courtyard plus margin_mm). Give exactly one.","read_only":false},{"name":"set_design_rules","title":"Set design rules","description":"Set the project design rules (.kicad_pro) and copper layer count. Works on a board workspace and on a generated design (create_design → start_board). On a generated design the rules go into circuit.kicad_pro/.kicad_dru in place (the previous ones are snapshotted under rules_revisions/), are kept by every later project write (project.zip, a new board run), the copper is not changed and KiCad DRC ju","read_only":false},{"name":"set_keepouts","title":"Keepout areas","description":"Add or remove keepout rule areas. Each keepout is a rect or polygon on the given copper layers (default all) and forbids what it names: no_tracks, no_vias, no_zone_fills (all three default true), no_pads, no_footprints. route_board keeps tracks and vias out of them and KiCad DRC enforces them. remove takes names (wildcards allowed).","read_only":false},{"name":"check_net_rules","title":"Check net classes and pairs","description":"Check the copper against the project's net classes and differential pairs, which KiCad's DRC does not: every class or pair net's narrowest track and the length below its class width, and every pair (X_P/X_N, X+/X-, CAN X_H/X_L) with its coupled share at the class's diff_pair_gap, both lengths and the skew. Routing applies the same rules.","read_only":false},{"name":"check_physics","title":"Check the physics","description":"Judge the copper by physics, which KiCad's DRC does not: impedance from the stackup on controlled nets, IR drop and heating on rails with a stated current, pair and lane skew, a ground via beside every high-speed layer change, 3W spacing between high-speed runs, and the via path under exposed paddles. Each check runs only when the board states something it can judge. With repair, the fixable findi","read_only":false},{"name":"set_zones","title":"Copper zones","description":"Add or remove copper zones (pours). Each zone pours its net on the given copper layers over rect or polygon, by default the whole board outline. priority orders overlapping zones (higher fills first); clearance_mm and min_thickness_mm override the rules; thermal false connects pads solid. remove takes zone or net names (wildcards allowed) and never touches keepout areas. Run fill_zones afterwards,","read_only":false},{"name":"add_copper","title":"Add tracks and vias","description":"Lay exact copper by hand where the routers leave a gap: tracks as polylines on one copper layer, and through vias. width_mm, diameter_mm and drill_mm default to the board's current track and via sizes. Nets must exist on the board. Nothing is checked here: run_drc afterwards, and ripup_routing takes copper back out.","read_only":false},{"name":"prune_vias","title":"Remove redundant vias","description":"Remove every via the board does not need: groups of vias come out, the zones are refilled and KiCad's unconnected count compared, and a via stays only if removing it disconnects something. nets limits the candidates (GND and the plane rails first: pours already join most of their pads). Runs for minutes on a large board; then fill_zones, run_drc.","read_only":false},{"name":"set_silkscreen","title":"Tidy the silkscreen","description":"Take clutter off the silkscreen. values \"hide\" (default) hides value and part-number fields; references \"keep\" (default), \"fab\" (moved to the fabrication layer) or \"hide\"; texts \"fab\" moves footprint texts off the silkscreen. run_drc's silk_overlap and silk_over_copper warnings count what is left.","read_only":false},{"name":"route_board","title":"Route the board","description":"Route under the project's rules and net classes. By default (no nets, no router, none of the single-route options below) it runs the full route pipeline Koppar benchmarks: the learned router on the whole board, repair rounds on what stays open, copper finishing (0/45/90 runs) and one repair round after it, inside one wall-clock cap: time_budget_s is that cap (default 1200, up to 1500), so the job ","read_only":false},{"name":"update_board_from_netlist","title":"Update the board from a changed netlist","description":"Bring a routed board to a changed circuit and keep every track that is still right: what KiCad calls Update PCB from Schematic, then the routing. New parts go on the board (place: a connector on an edge, the board grown when there is no room, the rest in free room near what they connect to; placements for exact poses), moved or re-netted pads lose only the branch of copper that led to them, copper","read_only":false},{"name":"repair_board","title":"Repair open connections","description":"Keep the copper of every net it already connects and route the nets still open around it: route_board with preserve_existing, with the learned router service. Default budget 120 s.","read_only":false},{"name":"ripup_routing","title":"Rip up routing","description":"Delete tracks and vias: of the given nets, on the given layers (vias are not layer-filtered), with an end inside region, or all. Filters combine. tracks/vias choose which kinds (both by default); zones also deletes the copper zones (pours) the same filters match (a zone inside region), never keepout areas. Locked items stay unless include_locked.","read_only":false},{"name":"cleanup_board","title":"Clean up tracks and vias","description":"Sweep the routing: zero-length and duplicate tracks, stub tracks (a free end, and everything the track touches stays joined without it), and vias that meet their net on fewer than two layers. Contact is copper overlap, as KiCad judges it. Refills the zones first so pours count as connections. Locked items stay. The board is put back if the unconnected count or the DRC errors rise. A track running ","read_only":false},{"name":"add_project_files","title":"Add files to the project","description":"Unpack a ZIP into the project folder, keeping its paths: new footprints into a .pretty library the fp-lib-table names, 3D models, a library table. Existing files are kept unless overwrite is true; the reply lists written, replaced and kept files. Base64, up to about 18 MB zipped.","read_only":false},{"name":"swap_footprint","title":"Swap footprints","description":"Replace footprints in place with another footprint from a library in the project's fp-lib-table (library:name): the reference, value, position, rotation (or rot_deg), side, lock and schematic link stay, and nets move pad by pad. pad_map maps a NEW pad number to the OLD pad whose net it takes, for packages numbered differently. The schematic symbols' Footprint fields are updated too. Reports new pa","read_only":false},{"name":"fill_zones","title":"Fill zones","description":"Refill every copper zone with KiCad's zone filler.","read_only":false},{"name":"stamp_silkscreen","title":"Stamp silkscreen","description":"Silkscreen stamps for release, both off unless asked for: a small spec badge (\"routed with Koppar\", optionally the title, revision and part count) in the largest free patch of the front or back silk, and JLCPCB's JLCJLCJLCJLC placeholder on the back silk so their order number is printed there, not on the front. Free means clear of pads, mask openings, other silk, courtyards, holes and the edge. Ki","read_only":false},{"name":"tie_rail_pads","title":"Tie plane-net pads together","description":"Tie neighbouring same-net SMD pads of the plane nets (GND, the rails with a pour) together on their own layer with short tracks, so a group shares one via to the plane instead of one via per pad, as a designer does. A tie is placed only where it misses every other net's pad, its tracks and vias, and the board edge. Before routing: route afterwards with preserve_existing (the default). After routin","read_only":false},{"name":"widen_nets","title":"Widen power nets in place","description":"Grow the tracks (and optionally vias) of the named nets in place, each as wide as its clearance to every other net's copper, holes and the board edge allows, up to the net's target width. Nothing moves and no via is added, so the score does not change. Routers neck power down to the signal width wherever the class width did not fit their grid; most necks have room around them. List the heaviest cu","read_only":false},{"name":"finish_board","title":"Finish the open nets","description":"Close what the router left open the way a designer does: for each open net the diagnosis names the copper boxing it in; that copper is ripped (never a poured net), the open nets are routed FIRST into the space, then the ripped nets go back around them; up to `rounds` rounds, each kept only if KiCad counts fewer unconnected items. Use it after route_board leaves a handful of nets open (route_board'","read_only":false},{"name":"bridge_islands","title":"Join pour islands","description":"A filled pour cut into islands by routing: one through-via per island that KiCad finds cut off from its net, placed well inside the island and inside the net's main copper on another layer, clear of every other net between. Reports the islands it found no site for. Run run_drc afterwards.","read_only":false},{"name":"tidy_copper","title":"Tidy the copper","description":"After routing: every run redrawn as the fewest 0/45/90-degree segments that clear, and every track narrower than its net's netclass width widened where it fits (slid sideways, bumped around a lone obstacle, or necked only over the stretch that needs it; a via or thin track of another net moved aside when that is all that is in the way). No via is added or removed; a change that would split a pour ","read_only":false},{"name":"polish_vias","title":"Fewer vias, net by net","description":"After route_board and prune_vias: rip one net at a time, most vias first, route it alone around everything else at a high via price, and keep the new copper only when KiCad counts fewer vias with no new open item or DRC error (a reroute that cuts a pour into islands first gets one via per island, bridge_islands). Run run_drc and get_score afterwards; a second pass sometimes finds more.","read_only":false},{"name":"couple_pairs","title":"Couple differential pairs","description":"After route_board: re-route the weakly coupled differential pairs one at a time, least coupled first. Both legs are ripped and routed alone around everything else as a pair; the new copper stays only when the pair's coupled share rises by min_gain_pct, its skew stays within max_skew_mm, KiCad counts no new open item or DRC error, and the board gains at most max_extra_vias vias. Pairs routed with t","read_only":false},{"name":"diagnose_open_nets","title":"Why nets do not route","description":"For every net still open (or the nets named): each pad with the escape corridors free on its own layer, whether a via can be dropped beside it at all, and what blocks it (which part's pads, which net's tracks or vias, the board edge). A pad with no free corridor and no via site is CRAMPED — no router can reach it; the advice names the parts to move. Otherwise the advice says which nets to rip and ","read_only":true},{"name":"run_drc","title":"Design-rule check","description":"KiCad's DRC on the board as it is now, with schematic parity when the project has its schematic: error and warning counts by type, shorts, unconnected items, parity items, and the first violations with their items and positions (types filters, max_violations caps; default 40). Also mount_fit: parts reaching through the board (mid-mount jacks, USB-C) checked against their cutouts from their 3D mode","read_only":true},{"name":"render_board","title":"Render the board (2D, exact)","description":"An exact 2D picture of the board as an engineer reads it: copper per layer (the facing layer full strength, the others faded), pads, vias, pours, outline, courtyards and refs. side top|bottom, region [x, y, w, h] mm for a crop, drc_markers to circle every DRC violation, ratsnest to draw the open connections, highlight_nets/highlight_refs in magenta. The pixel-per-mm scale and region come back so a","read_only":true},{"name":"export_step","title":"Export STEP","description":"Export the assembled board as STEP (3D models, DNP parts left out). Download it as workspace.step; workspace.zip includes it.","read_only":true},{"name":"list_board_revisions","title":"Board revisions","description":"The snapshots of this board, newest first. Revision N is the board as it was before change N (revision 0 is the project as imported); restore_board_revision N goes back to it.","read_only":true},{"name":"restore_board_revision","title":"Restore a revision","description":"Put the board and its rules back as they were in a revision from list_board_revisions. The current board is saved as a new revision first, so the restore itself can be undone.","read_only":false},{"name":"get_board_job","title":"Board job","description":"The design's latest board job: its status and, once it ends, its result or error. wait_s holds the call until it ends. A job is allowed the time its budget asks for (time_budget_s, total_budget_s, rounds), and survives a server restart (the op starts over from its snapshot; route_board's pipeline goes on from its last finished stage).","read_only":true},{"name":"stop_board_job","title":"Stop the board job","description":"Stop the design's running or queued board job (the KiCad plugin's Stop button). The board goes back to how it was before the job (its snapshot); a job already ended is left as it is.","read_only":false}],"server_info":{"name":"koppar","version":"0.1.0"},"category":"design","tags":["agents","ecommerce","hr"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-17","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-koppar-koppar/"}