Protoship is an MCP server published by dev.protoship, hosted at mcp.protoship.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including check_project, match_parts, estimate_build, request_finish, request_status.
Checks an ESP32 project (board, pins, power, JLCPCB parts, costs) and gets the build finished.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Reads an ESP32 project from a public GitHub repo (or a folder or file in it, or a raw file link) or from files you pass inline, and returns: the board and chip, firmware type, the modules it uses, every GPIO it assigns with findings (flash pins, strapping pins, input-only pins, the board's own display/touch/SD pins, octal PSRAM pins), power notes, whether there is a custom PCB, BOM or enclosure files, whether the build fits Finish my build, and next steps. Free, read-only, stores nothing.
| Parameter | Type | Description |
|---|---|---|
| url | string | https link to a public GitHub repo, a folder (…/tree/branch/path) or a file, or any raw file URL. |
| files | array | Project files inline instead of url: ESPHome YAML, platformio.ini, sketch (.ino/.cpp/.h), KiCad schematic, BOM CSV. Up to 12 files, 200 kB each. |
None yet. Changes appear after a server's second daily check.
Inferred from the host name and headers: what a server runs on, not who runs it.
{
"name": "check_project",
"title": "Check an ESP32 project",
"description": "Reads an ESP32 project from a public GitHub repo (or a folder or file in it, or a raw file link) or from files you pass inline, and returns: the board and chip, firmware type, the modules it uses, every GPIO it assigns with findings (flash pins, strapping pins, input-only pins, the board's own display/touch/SD pins, octal PSRAM pins), power notes, whether there is a custom PCB, BOM or enclosure files, whether the build fits Finish my build, and next steps. Free, read-only, stores nothing.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "https link to a public GitHub repo, a folder (…/tree/branch/path) or a file, or any raw file URL."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string"
},
"content": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 12,
"description": "Project files inline instead of url: ESPHome YAML, platformio.ini, sketch (.ino/.cpp/.h), KiCad schematic, BOM CSV. Up to 12 files, 200 kB each."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check an ESP32 project",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Checks each BOM line against JLCPCB's basic and preferred-extended parts. Those load without a feeder fee on Economic assembly; every other unique part costs one. Matches by LCSC number (Cxxxx), manufacturer part number, or for resistors, capacitors and inductors by value and chip size, and suggests a footprint change when the same value is basic in another size. Returns per line status, part and price, plus the feeder fees in total. Works on Protoship's stored copy of the parts list (its date is in the result) and calls no outside service. Free, read-only.
| Parameter | Type | Description |
|---|---|---|
| bom * | any | The BOM as CSV text (KiCad or JLCPCB export: reference/designator, value/comment, footprint, quantity, mpn, lcsc columns) or as a list of lines. |
{
"name": "match_parts",
"title": "Match a BOM against JLCPCB basic parts",
"description": "Checks each BOM line against JLCPCB's basic and preferred-extended parts. Those load without a feeder fee on Economic assembly; every other unique part costs one. Matches by LCSC number (Cxxxx), manufacturer part number, or for resistors, capacitors and inductors by value and chip size, and suggests a footprint change when the same value is basic in another size. Returns per line status, part and price, plus the feeder fees in total. Works on Protoship's stored copy of the parts list (its date is in the result) and calls no outside service. Free, read-only.",
"inputSchema": {
"type": "object",
"required": [
"bom"
],
"properties": {
"bom": {
"anyOf": [
{
"type": "string",
"maxLength": 100000
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"mpn": {
"type": "string"
},
"qty": {
"type": "integer"
},
"ref": {
"type": "string"
},
"lcsc": {
"type": "string"
},
"value": {
"type": "string"
},
"footprint": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 200
}
],
"description": "The BOM as CSV text (KiCad or JLCPCB export: reference/designator, value/comment, footprint, quantity, mpn, lcsc columns) or as a list of lines."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Match a BOM against JLCPCB basic parts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Compares ordering a small PCB yourself (JLCPCB bare boards and Economic assembly, AISLER in Germany; fees, shipping, EU import duty and lead times from a price table Protoship checked by hand on the vendors' own pages; the result carries the links and the date checked) with having the existing build finished by Protoship. Computes from that stored table only and calls no outside service. Leaves out what it does not know instead of guessing. Free, read-only.
| Parameter | Type | Description |
|---|---|---|
| boards | integer | Bare boards to order. Default 5. |
| joints | integer | Solder joints per board, if known. |
| layers | integer | Copper layers. Default 2. |
| country | string | Two-letter EU country code of the delivery address. Default DE. |
| board_mm | array | Board width and height in mm. Default [50, 50]. |
| assembled | integer | Boards to have assembled. Default 0. |
| extended_parts | integer | Unique parts outside basic/preferred (from match_parts). |
| parts_cost_usd | number | Parts cost per board in USD (from match_parts), if known. |
{
"name": "estimate_build",
"title": "Estimate cost and lead time",
"description": "Compares ordering a small PCB yourself (JLCPCB bare boards and Economic assembly, AISLER in Germany; fees, shipping, EU import duty and lead times from a price table Protoship checked by hand on the vendors' own pages; the result carries the links and the date checked) with having the existing build finished by Protoship. Computes from that stored table only and calls no outside service. Leaves out what it does not know instead of guessing. Free, read-only.",
"inputSchema": {
"type": "object",
"properties": {
"boards": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Bare boards to order. Default 5."
},
"joints": {
"type": "integer",
"minimum": 0,
"description": "Solder joints per board, if known."
},
"layers": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Copper layers. Default 2."
},
"country": {
"type": "string",
"description": "Two-letter EU country code of the delivery address. Default DE."
},
"board_mm": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"description": "Board width and height in mm. Default [50, 50]."
},
"assembled": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Boards to have assembled. Default 0."
},
"extended_parts": {
"type": "integer",
"minimum": 0,
"description": "Unique parts outside basic/preferred (from match_parts)."
},
"parts_cost_usd": {
"type": "number",
"minimum": 0,
"description": "Parts cost per board in USD (from match_parts), if known."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Estimate cost and lead time",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Sends your user's working ESP32 build to Protoship as a Finish my build request: an individual service on their own hardware (case made for their board, wiring fixed, firmware flashed and tested, back as a USB-C device). Protoship sends one email to confirm the address; after that it answers within two working days with questions or a fixed price. Nothing is binding and nothing is paid until your user accepts a price. Use only your user's own email address, only with their consent. Privacy policy: https://protoship.dev/privacy
| Parameter | Type | Description |
|---|---|---|
| board * | string | The board and main modules, e.g. "Cheap Yellow Display with a BME280". |
| check | string | A short summary of check_project, if you ran it. Optional. |
| email * | string | Your user's email address. |
| country | string | Two-letter country code for the return shipment. Optional. |
| description * | string | What the build does and where it should live (desk, wall, in the hand). |
| project_url | string | Link to the firmware repo, ESPHome YAML or AI chat. Optional. |
{
"name": "request_finish",
"title": "Request Finish my build",
"description": "Sends your user's working ESP32 build to Protoship as a Finish my build request: an individual service on their own hardware (case made for their board, wiring fixed, firmware flashed and tested, back as a USB-C device). Protoship sends one email to confirm the address; after that it answers within two working days with questions or a fixed price. Nothing is binding and nothing is paid until your user accepts a price. Use only your user's own email address, only with their consent. Privacy policy: https://protoship.dev/privacy",
"inputSchema": {
"type": "object",
"required": [
"email",
"board",
"description"
],
"properties": {
"board": {
"type": "string",
"maxLength": 280,
"description": "The board and main modules, e.g. \"Cheap Yellow Display with a BME280\"."
},
"check": {
"type": "string",
"maxLength": 1000,
"description": "A short summary of check_project, if you ran it. Optional."
},
"email": {
"type": "string",
"format": "email",
"description": "Your user's email address."
},
"country": {
"type": "string",
"description": "Two-letter country code for the return shipment. Optional."
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "What the build does and where it should live (desk, wall, in the hand)."
},
"project_url": {
"type": "string",
"description": "Link to the firmware repo, ESPHome YAML or AI chat. Optional."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Request Finish my build",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Returns the state of a request: pending (waits for your user to confirm the email), confirmed (on its way to Protoship), forward_failed (confirmed, sent again within the hour), forwarded (Protoship has it and answers by email within two working days), answered, closed.
| Parameter | Type | Description |
|---|---|---|
| request_id * | string | The id request_finish returned, e.g. F-7KQ2M9XW. |
{
"name": "request_status",
"title": "Check a Finish my build request",
"description": "Returns the state of a request: pending (waits for your user to confirm the email), confirmed (on its way to Protoship), forward_failed (confirmed, sent again within the hour), forwarded (Protoship has it and answers by email within two working days), answered, closed.",
"inputSchema": {
"type": "object",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"description": "The id request_finish returned, e.g. F-7KQ2M9XW."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check a Finish my build request",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Puts your user on the Protoship waitlist for ordering PCBs, 3D prints, CNC parts and sheet metal through their agent. Protoship sends one email to confirm the address, later one with the invite. No newsletter. Use only your user's own email address and only with their consent. Privacy policy: https://protoship.dev/privacy
| Parameter | Type | Description |
|---|---|---|
| email * | string | Your user's email address. |
| device | string | What your user wants to build, in a sentence. Optional. |
| interests | array | What your user wants to order. Optional. |
{
"name": "join_waitlist",
"title": "Join the Protoship waitlist",
"description": "Puts your user on the Protoship waitlist for ordering PCBs, 3D prints, CNC parts and sheet metal through their agent. Protoship sends one email to confirm the address, later one with the invite. No newsletter. Use only your user's own email address and only with their consent. Privacy policy: https://protoship.dev/privacy",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "Your user's email address."
},
"device": {
"type": "string",
"maxLength": 280,
"description": "What your user wants to build, in a sentence. Optional."
},
"interests": {
"type": "array",
"items": {
"enum": [
"pcbs",
"3d_prints",
"cnc_parts",
"sheet_metal",
"assembled_devices",
"not_sure"
],
"type": "string"
},
"description": "What your user wants to order. Optional."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Join the Protoship waitlist",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Protoship helps turn a working ESP32 project into a finished device. Use check_project on the user's repo or files to identify the board, list the pins it uses against the board's strapping, flash and on-board pins, and flag power problems. For a custom PCB, match_parts checks the BOM against JLCPCB basic and preferred parts (no feeder fee), and estimate_build compares ordering the boards yourself (JLCPCB, AISLER, with sourced prices) with Protoship's Finish my build service: the user sends their working build, a workshop in Germany builds it into a case made for the board, flashes and tests the firmware and sends it back powered over USB-C. If the user wants that, call request_finish with their consent. check_project, match_parts and estimate_build are free, need no account and store nothing. Using the tools means accepting the terms at https://protoship.dev/terms. Website: https://protoship.dev
Names, descriptions and schemas were written by the server and are shown as data.