# Meshpit

> Meshpit is a browser-based parametric 3D model editor and sharing platform powered by OpenSCAD compiled to WebAssembly. Users write or AI-generate OpenSCAD code, preview the model in a live Three.js viewer, adjust interactive parameters, and download STL files for 3D printing — all without installing any software.

Meshpit supports human-in-the-loop AI workflows via WebMCP. When the editor is open, AI agents can read and write OpenSCAD code, inspect and adjust model parameters, control 3D viewer settings, and trigger editor actions (save, fork, screenshot, AI assist, etc.) through `navigator.modelContext` tools. Connect using the [WebMCP Bridge Chrome extension](https://chromewebstore.google.com/detail/webmcp-bridge/chgjbookknohehmaocfijekhaocaanaf).

Key concepts:
- OpenSCAD is a declarative CAD scripting language. Models are defined with code, not clicks.
- Parameters are declared in OpenSCAD source using `/* [Group Name] */` comment blocks. Each parameter becomes an interactive UI control (slider, dropdown, color picker, etc.).
- The 3D viewer renders models in real time using Three.js with PBR materials, SSAO, bloom, and soft shadows.
- Models can be published publicly, shared via URL, embedded as iframes, and sold with a download price.

## Pages

- [Editor (new model)](https://meshpit.app/playground/new): Blank OpenSCAD editor with live 3D preview. Start here to create a model.
- [Explore](https://meshpit.app/playground/explore): Browse and search public models made by the community.
- [Changelog](https://meshpit.app/playground/changelog): Release notes for Meshpit updates.
- [Blog](https://meshpit.app/playground/blog): Tutorials and guides for using Meshpit.

## Key blog posts and tutorials

- [Getting Started](https://meshpit.app/playground/blog/2026-02-25-getting-started): Introduction to Meshpit and OpenSCAD basics.
- [Advanced Parameters](https://meshpit.app/playground/blog/2026-03-03-advanced-parameters): How to declare sliders, dropdowns, color pickers, and other parameter types.
- [Custom Lighting](https://meshpit.app/playground/blog/2026-02-27-custom-lighting): Using scene lighting functions (ambient, directional, point, spot lights).
- [Multi-Color Models](https://meshpit.app/playground/blog/2026-02-26-multi-color-models): Applying multiple colors to a single model using color() in OpenSCAD.
- [File Imports](https://meshpit.app/playground/blog/2026-03-01-file-imports): Importing SVG, STL, DXF, and other files into a model.
- [Libraries](https://meshpit.app/playground/blog/2026-02-28-libraries): Using BOSL2, MCAD, LEGO, gridfinity, and other OpenSCAD libraries.
- [JS Texture Scripts](https://meshpit.app/playground/blog/2026-03-20-js-texture-scripts): Writing JavaScript texture scripts for procedural materials.
- [Modularisation](https://meshpit.app/playground/blog/2026-03-08-modularisation): Organising OpenSCAD code into modules and project files.
- [Meshpit API Reference](https://meshpit.app/playground/blog/2026-03-17-meshpit-api-reference): Full reference for Meshpit-extended OpenSCAD functions (lights, scene settings, materials, cameras, grids).
- [Grid API](https://meshpit.app/playground/blog/2026-03-19-grid-api): plane_grid(), cube_wireframe(), sphere_wireframe() reference.
- [Picture-in-Picture Cameras](https://meshpit.app/playground/blog/2026-03-21-picture-in-picture-cameras): Using camera_pip() to add secondary viewport overlays.
- [Scene Settings API](https://meshpit.app/playground/blog/2026-03-18-scene-settings-api): scene_material(), scene_shadows(), scene_bloom(), scene_ssao(), scene_background() reference.

## WebMCP / AI agent integration

- [WebMCP Manifest](https://meshpit.app/.well-known/mcp.json): Machine-readable description of all available tools and workflows.
- Tools are registered on `navigator.modelContext` when the editor is open.
- Available tool groups: code read/write (`get_current_code`, `set_code`), parameters (`get_parameters`, `set_parameter`), viewer state (`get_viewer_state`, all toggle tools), model metadata (`get_model_info`), editor actions (save, fork, share, screenshot, AI assistant, version history), code insertions (primitives, booleans, transforms, snippets), and navigation.

## Optional

- [OpenSCAD Language Reference (Wikibooks)](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual): Complete OpenSCAD language documentation.
- [BOSL2 Library Wiki](https://github.com/BelfrySCAD/BOSL2/wiki): Documentation for the BOSL2 extended shape library.
- [OpenSCAD Cheatsheet](https://openscad.org/cheatsheet/): Quick reference for OpenSCAD built-in functions.