EasyGerber: AI PCB design, layout, and routing

EasyGerber: AI PCB design, layout, and routing

This package connects coding agents to EasyGerber's hosted board-design tools. Its public files contain workflow instructions, connection metadata, icons, and a small installer. Board layout, routing, and scoring run on EasyGerber's servers.

Version 0.3.8 uses one private board reference for creation and continued work. The service selects account ownership or private access automatically, exposes the current layout job for status reads, and preserves existing-client compatibility. Ordinary OpenAI sign-in explicitly requests only workflow permissions; deletion remains a separate consent. Hosted tools and package instructions must both be current; package checks alone do not establish a live client workflow.

Source is available in the public integration repository. The npm installer and platform plugin packages have separate client-validation processes and share the EasyGerber workflow skill and hosted service.

Start without signing up

Use `https://www.easygerber.com/api/mcp` to search published parts and create a board without signing up. The agent uses one private boardRef for creation, edits, layout, checks, previews, and exports. The service uses the connected account when valid or establishes private access automatically. There is no user-facing guest setup or separate token to manage. Keep the private board link out of public messages and repositories.

The Codex installer, OpenAI packages, and Claude package use the general URL. The Grok account connector and native Cursor and Antigravity configurations below use the account-only URL. For a new guest connection, leave authentication unset; a rejected existing account credential must be reauthorized and will not silently become a guest connection. See Create and continue without signing up for private access and account transitions.

Grok

Connect your EasyGerber account once to open and edit saved boards in consumer Grok:

1. In Grok, open Plugins → New Connector → Custom.
2. Name the connector EasyGerber and enter https://www.easygerber.com/api/mcp/account as the server URL.
3. Complete EasyGerber sign-in and choose Allow access. Then ask Grok to open a saved board by its EasyGerber URL and make your requested changes.

For example: “Open this saved EasyGerber board: [your board URL]. Rename it to LED indicator and read it again to confirm the change was saved.”

This account entry requires authorization during connection setup and uses the existing EasyGerber tools and account permissions. For a new connection to the account entry, complete its normal sign-in flow. Existing published package configurations continue to use /api/mcp, which supports guest use and optional account authorization.

On October 16, 2026, consumer Grok completed consent, read an existing private saved board, saved a temporary name change, and restored the original name. Both changes were confirmed after reopening the board on the EasyGerber website. Grok Bot has not been tested. Browser 3D rendering was not verified because WebGL was unavailable in the test browser. This consumer check does not establish Grok Build's interactive OAuth or model-driven board workflow.

Cursor

The public repository includes a native .cursor-plugin/plugin.json manifest. It uses the shared EasyGerber skill and artwork and connects to https://www.easygerber.com/api/mcp/account. This entry requires account authorization before tools become available; complete EasyGerber sign-in and choose Allow access in Cursor's connection flow. Account permissions, plan limits, and generation billing still apply.

To load a checkout of the public repository in the official Cursor CLI:

agent --plugin-dir .

Enter /mcp, select Easygerber (plugin), and choose Manage Server → Login to complete the browser consent flow. Then ask: “Open this saved EasyGerber board: [your board URL]. Read its current name and components.” Cursor manages the account credentials. The npm installer is not required; it configures Codex only. The root OpenAI and Claude connection configurations retain guest-capable /api/mcp access. Marketplace publication is subject to Cursor review.

Antigravity

Design and lay out PCBs in Antigravity using published components, automatic placement and routing, schematic editing, and manufacturing exports. The public repository includes native Antigravity metadata and the shared EasyGerber skill. Its MCP connection uses https://www.easygerber.com/api/mcp/account; account permissions, plan limits, and generation billing still apply.

Install the plugin from the public repository with the current Antigravity CLI and start a session:

agy plugin install https://github.com/EasyGerber/easygerber-agent-plugin

agy

Use /mcp to inspect the EasyGerber connection. Complete EasyGerber sign-in and choose Allow access when Antigravity requests account authorization. Then ask: “Open this saved EasyGerber board: [your board URL]. Read its current name and components.” Antigravity manages the account credentials. The npm installer is not required. Marketplace publication is subject to Antigravity review.

See the official plugin guide and MCP guide.

Cline

Cline can connect directly to EasyGerber's hosted MCP endpoint using Streamable HTTP. Use an existing Cline installation with a configured model. The npm setup installer in this repository configures Codex only; it is not the Cline installation path. No local EasyGerber server, build, or API key is needed for a new guest connection.

In the Cline IDE panel, open MCP Servers → Remote Servers, enter EasyGerber as the server name and https://www.easygerber.com/api/mcp as the server URL, choose Streamable HTTP, and select Add Server. Leave authentication unset for guest access.

Alternatively, open MCP Servers → Configure → Configure MCP Servers and merge this entry into the existing mcpServers object, preserving other servers and settings:

{

"mcpServers": { "easygerber": { "type": "streamableHttp", "url": "https://www.easygerber.com/api/mcp", "disabled": false, "autoApprove": [] } } }

The explicit streamableHttp type matters: omitting it selects legacy SSE in Cline. Keep tool approval enabled. If easygerber already exists, inspect that entry instead of replacing it or creating a duplicate.

With the current Cline CLI, the equivalent configuration command is:

cline mcp add easygerber https://www.easygerber.com/api/mcp --transport http --yes

This command saves the connection; it does not by itself prove successful setup. In Cline, verify that the connection succeeds and EasyGerber tools such as search_parts, get_part, and create_board appear. For an installation-only check, stop after tool discovery; do not start a guest session, create or modify a board, generate a layout, export files, or send feedback.

For later user-requested board work, guest access supports one board per session before signup. Saved account boards require EasyGerber OAuth consent. Clients that require authorization during connection setup can use the separate https://www.easygerber.com/api/mcp/account entry described above. Account authorization and board workflows need their own Cline validation; the guest connection check does not verify them.

These instructions follow the official Cline MCP guide. On October 18, 2026, Cline CLI 3.0.73 read the proposed README and wrote the native connection configuration into an empty isolated profile with tool approvals enabled. A separate check using its installed @cline/core 0.0.95 connected and discovered 17 EasyGerber tools without authentication. The agent itself did not verify discovery. No EasyGerber tool was called; OAuth and board operations were not tested.

Kiro

Install the Kiro power folder through Powers → Add Custom Power, or run kiro-cli --v3 powers install ./kiro from a local checkout of this public repository and start kiro-cli --v3. The npm installer is not needed. The power uses the guest-capable /api/mcp entry and includes the complete EasyGerber workflow in its skill.

On October 18, 2026, Kiro CLI 2.32.0 V3 imported and explicitly activated the power, read its complete skill, and discovered 17 hosted tools without EasyGerber authentication. Its native guest workflow selected published parts, created and revised a board, completed layout generation, read preview data, checked for blockers, and exported manufacturing and EasyGerber files. A separately configured /api/mcp/account connection completed OAuth and successfully saved that guest board to a personal account after resuming the same conversation; a subsequent read confirmed the account board and its saved layout. A separate browser check rendered the saved board's 3D parts.

The power's automatic mid-session OAuth did not complete in this CLI version. Use the optional account connection and resume instructions in the Kiro README for account work and guest-board saving. Complete browser consent while Kiro's local callback listener is active; an earlier account-endpoint attempt expired after about 60 seconds, separately from the power's mid-session authorization-state error. Token refresh, deletion, feedback, and keyword-only activation remain untested in Kiro. Directory approval is separate from these checks.

Gemini CLI

Install the EasyGerber extension in the current Gemini CLI. Gemini's model sign-in is separate from EasyGerber: a new EasyGerber guest connection needs no account or API key.

gemini extensions install https://github.com/EasyGerber/easygerber-agent-plugin

gemini extensions list gemini skills list gemini mcp list

Review the extension's MCP connection and accept the normal installation prompt. Restart an existing Gemini session after installation. Confirm that the easygerber extension and shared skill are enabled and that the EasyGerber MCP connection is available. Existing user or workspace settings with the same server or skill name can take precedence over an extension; inspect them if the displayed connection or skill comes from another source.

The extension connects to https://www.easygerber.com/api/mcp using Streamable HTTP and loads the existing skills/easygerber workflow. It includes no local EasyGerber server or engine. Keep Gemini's normal tool approval prompts enabled. Try: “Use EasyGerber to create a board from the pin assignments in this firmware.” The agent selects published components and uses the g