Jet3D Model Context Protocol (MCP) Server

Official Model Context Protocol (MCP) server for Jet3D.pl — custom 3D-printed confectionery cookie cutters and stamps manufactured on-demand in Poland.

This server enables AI assistants (Claude Desktop, Cursor, Windsurf, Zed, and autonomous AI agents) to:

• 🎨 Design personalized 3D confectionery cutters & stamps (8 geometric shapes, 5 typography styles, custom relief).

• 💰 Calculate transparent pricing in PLN (physical sets & instant digital 3MF/STL downloads).

• 📜 Verify food-contact safety compliance (EU FCM DoC, Regulation EC 1935/2004, GMP EC 2023/2006).

• 🚀 Generate Instant BLIK Checkout links with pre-filled delivery inputs (InPost Paczkomat, email, phone) and automatic BLIK input focus (< 5 second checkout).

🛠️ MCP Features

1. Tools

2. Resources

3. Prompts

🚀 Quick Start & Client Configuration

Claude Desktop

Add this configuration to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Option A: Run via NPX (Recommended)

{
  "mcpServers": {
    "jet3d": {
      "command": "npx",
      "args": [
        "-y",
        "@toomus/jet3d-mcp"
      ]
    }
  }
}

Option B: Run via Local Clone

{
  "mcpServers": {
    "jet3d": {
      "command": "node",
      "args": [
        "/path/to/jet3d-mcp/build/index.js"
      ]
    }
  }
}

Option C: Run via Docker

{
  "mcpServers": {
    "jet3d": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "toomus/jet3d-mcp"
      ]
    }
  }
}

Cursor IDE

Add the server to your project or user .cursor/mcp.json:

{
  "mcpServers": {
    "jet3d": {
      "command": "npx -y @toomus/jet3d-mcp"
    }
  }
}

Smithery.ai (1-Click Install)

To install Jet3D MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @toomus/jet3d-mcp --client claude

💡 How It Works (AI Agent Workflow)

1. User asks AI assistant:

   "Chcę zamówić foremkę do ciastek w kształcie serca z napisem 'Sto Lat Aniu!' na urodziny mojej siostry. Paczkomat KRA01M."

2. AI calls create_custom_cutter_checkout:

   {
     "shape": "heart",
     "diameter_mm": 70,
     "text_line_1": "Sto Lat Aniu!",
     "font_line_1": "script",
     "paczkomat_code": "KRA01M",
     "order_type": "physical"
   }

3. AI responds with complete order breakdown and checkout link:

   • Produkt: Foremka 2-częściowa (wykrawacz + stempel 2.8 mm) — 34,90 zł

   • Atest: Food-Contact PLA (certyfikat UE DoC/GMP)

   • Dostawa: Paczkomat InPost — 16,99 zł

   • Razem: 51,89 zł

   • Link: https://jet3d.pl/checkout/new?shape=heart&diameter_mm=70&text_line_1=Sto+Lat+Aniu%21&font_line_1=script&paczkomat=KRA01M&...

4. Zero-Friction Checkout: When the customer clicks the link:

   • 3D preview and delivery address are already populated.

   • The cursor automatically focuses on the 6-digit BLIK code input (autofocus).

   • The customer enters their BLIK code, taps confirm on their mobile banking app, and the order is placed in seconds!

📦 Development & Local Testing

Prerequisites

• Node.js >= 20.0.0

• npm >= 9.0.0

Build & Run

# 1. Clone the repository
git clone https://github.com/toomus/jet3d-mcp.git
cd jet3d-mcp

# 2. Install dependencies
npm install

# 3. Compile TypeScript
npm run build

# 4. Run via MCP Inspector for local debugging
npx @modelcontextprotocol/inspector node build/index.js

Docker Build

docker build -t jet3d-mcp .
docker run -i --rm jet3d-mcp

🔒 Security & Food Contact Certification

• Material: 100% virgin Food-Safe PLA bioplastic.

• Regulations: Manufactured according to Good Manufacturing Practice (GMP) under Regulation (EC) No 2023/2006 and compliant with Framework Regulation (EC) No 1935/2004 and Commission Regulation (EU) No 10/2011.

• Migration Limits: Verified by accredited analytical testing (overall & specific migration limits).

• Declaration of Compliance (DoC): Available on request for confectioneries, bakeries, and culinary businesses.

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

Copyright (c) Tomasz Boyke (Jet3D.pl).