RhinoArtisan MCP exposes the same automation surface that powers Flow Studio scripts — design, editing, analysis, manufacturing, pricing and reporting. Your assistant picks up new tools automatically: connect once, and every release makes it more capable.
Read-only tools are separated from tools that modify the document, so assistants can explore your design safely before they act. Anything they create lands in your document as a normal, undoable Artisan operation — parametric, grouped and layered exactly as if you had used the panel yourself.
All dimensions are millimetres. Omitting a dimensional argument (or passing 0) keeps the tool’s default — the same defaults you have saved in RhinoArtisan.
Understand the document (read-only)
| Tool | What it does |
|---|
describe_document | Human-readable summary of the design: type, finger size, metals, gems and parametric elements |
list_gems | Every gem: shape, material, carats, size in mm, position and layer |
list_objects | Every parametric object (shanks, halos, bezels, baskets, pegheads, pavé rows, cutters…) with its parameters |
get_gem_options | The valid gem shapes and materials |
get_document_settings | Computation mode, metals per layer, finger size, valid regions and metal names |
list_assets | The profile assets (RING_PROFILE, BEZEL_PROFILE, CHANNEL_PROFILE…) the profile arguments accept |
check_gem_collisions | Pairs of gems that touch or overlap |
Gems
| Tool | What it does |
|---|
add_gem | Creates a gem by shape, material, carat weight and position |
edit_gem | Changes material, carats, size, rotation or position of an existing gem — or flips it |
gem_tools | The gem utilities: centers, shared-prong circles, curves from/around gems, history-linked offsets, copy-by-gems, color by size, batch rotation, tags, recover |
Rings and shanks
| Tool | What it does |
|---|
create_ring | Classic comfort-fit shank at any finger size, optionally with a gem row on top |
create_cathedral | Cathedral shank — arms rising toward the setting — optionally with a pavé row on top |
create_eternity | Eternity band with gems all around |
create_toi_et_moi | Toi et Moi top: two stones straddling the finger, one leaning to each side |
create_ring_curve | The editable ring rail curve (closed, open, bypass or shaped) that curve tools build on |
Settings
| Tool | What it does |
|---|
add_prong_setting | Peghead (prong head) around a gem, as a parametric child of it |
add_bezel_setting | Bezel around a gem |
add_basket_setting | Basket under one or many gems |
create_halo | Halo of small stones around a center gem, with channel and optional shared/scalloped prongs |
create_hidden_halo | Hidden halo tucked under the setting, visible from the side |
create_cluster | Cluster of small stones hugging the center gem, illusion-style |
create_tulip | Tulip setting — prongs blooming from a stem |
create_martini | Martini setting — the V-shaped stud basket |
create_trellis_setting | Trellis setting — interwoven curved prongs |
add_advanced_bezel | Advanced bezel with per-point profile control |
add_advanced_basket | Advanced basket — round, double, triple, claw or custom-profile prongs and configurable rails |
create_cabochon | Domed unfaceted stone (creates its own stone) |
create_pearl | Pearl with optional calotte cap and wire post |
create_cutters | The cutting/drilling solids that open each gem’s seat in the metal |
create_microsetting | Pavé infrastructure for a run of small gems: cutters, V-cutters, channel, row prongs |
Pavé and gems along geometry
| Tool | What it does |
|---|
gems_on_curve | A row of identical gems along any curve, with optional shared prongs and cutters |
create_channel | A metal channel with a run of gems inside, following a curve |
pave_surface | Automatic pavé: fills any surface with diamonds, sized and packed automatically |
Booleans
| Tool | What it does |
|---|
boolean_operation | Artisan’s parametric-aware union / difference / intersection / split — keeps the mother/child relations alive |
Components and decoration
| Tool | What it does |
|---|
create_component | Accessories: bangle, bead, charm, link, name pendant, hinge, milgrain, rope, voronoi, honeycomb, 3D texture, chain, huggie, pattern, profile sweep, ring engraving |
user_elements | List the document’s named user elements, or tag objects as a new one |
create_bail | The pendant hanger loop, with optional o-ring |
text_on_curve | Text along a curve, flat or extruded, in any installed font |
vectorize_image | Traces a raster image into vector curves |
Documents and views
| Tool | What it does |
|---|
open_document | Opens a 3dm (never prompts — fails on unsaved changes unless told to discard) |
save_document | Save / Save As |
new_document | New document from the default or a given template |
describe_views | Viewports, named views and display modes available |
set_view | Point a viewport: named view, explicit camera + lens, display mode, zoom extents |
capture_viewport | Capture a viewport to PNG at any resolution — the batch-rendering workhorse |
Editing and cleanup
| Tool | What it does |
|---|
edit_object | Changes any parameter of a parametric object (width, prong count, stone size…) — it regenerates in place |
delete_objects | Deletes gems, parametric groups or plain geometry by id |
set_document_settings | Metal per layer, finger size, computation mode (Render / Manufacturing) |
Weight, price and analysis
| Tool | What it does |
|---|
calculate_weight | Metal weight per layer, in the document’s metals or any metal you name |
calculate_price | Price breakdown with the active manufacturer — category totals, or every line with detailed; certified diamonds quoted live on Nivoda (skippable) |
get_pricing_settings | The manufacturer’s cost tables as JSON: metal spot prices, diamond price tables, process and labor costs |
set_pricing_setting | Update one cost by path (e.g. Markets.Gold = 68.5) — persisted, priced on the next calculation |
analyze_thickness | Wall thickness at any point, for printability and casting checks |
scale_by_weight | Scales a design so it weighs exactly the grams you want |
Manufacturing
| Tool | What it does |
|---|
check_printability | Verifies meshes are valid and watertight, recoloring green/red like ArtisanQuickCheck |
global_thickness | Wall-thickness map of the whole piece: min/max/average, thin percentage and the thinnest spots |
repair_for_printing | Repairs geometry into a single watertight printable mesh |
add_sprue | Casting connectors in every style of the family: single, inner tree/branches, external tree/frames, radial tree, cluster tree, curve, helix, spiral, multiple copies |
resize_ring | Batch-resizes a ring mesh to a list of target sizes |
decimate_mesh | Reduces polygon count by percentage or to a tolerance |
| Tool | What it does |
|---|
scale_to_dimensions | Scale to exact target dimensions — “make it 20 mm wide” |
scale_by_weight | Scale so it weighs exactly the grams you want |
deform_objects | Artisan’s bend / twist / taper — curve a flat motif around the ring |
place_on_objects | Copy or move objects onto surfaces, oriented to the target |
move_by_normal | Lift or sink elements along the surface normal |
mirror_objects | Mirror to the opposite side or into the four quadrants |
Relief
| Tool | What it does |
|---|
create_relief | One-shot 2.5D relief from an image heightmap, closed curves or geometry |
relief_operations | The layered operation stack: add profile/extrude/image/texture/geometry ops, combine modes, reorder, toggle |
relief_project | Configure the project, bake the mesh (re-editable), export the 16-bit heightmap for CNC |
Reports, exports and render
| Tool | What it does |
|---|
create_report | A report from your templates: title-block fields, custom fields, cost/gem/process tables and gems map filled in — or the legacy auto A4 |
list_report_templates | The report templates available |
create_breakdown_table | Draws a cost table (metals, gems, processes or extras) in the document |
create_gems_table / create_metals_table | The gems and metals tables drawn in the production sheet |
create_gems_map | The per-size gem legend used in production drawings |
generate_dimensions | Automatic dimensioning, generic or ring-specific |
export_gems_list | The gems list as CSV |
export_stl | Everything visible as a binary STL, ready for 3D printing |
export_pdf | A layout page as a 300-dpi PDF |
export_glb | The whole document as GLB |
render_screenshot | Opens the Realtime Render viewer and saves a PNG frame from any camera preset |
apply_materials | Switch every object between design and render materials |
batch_render | Render every 3dm in a folder with Rhino’s renderer, one image per file |
list_render_scenes / apply_render_scene | The Render Studio’s environments and material families — browse and apply |
render_still / render_turntable | Photoreal stills and turntable MP4s through the studio pipeline |
import_named_views | Bring standard camera angles in from a template 3dm |
Library and services
| Tool | What it does |
|---|
search_files | Searches your indexed design library by content (gems, metals, design semantics) |
search_diamonds | Searches certified diamonds on Nivoda by shape and carats |
Example session
You: Make me a 1-carat halo engagement ring, size 54, and tell me what it weighs in 18k white gold.
Your assistant places the center stone, builds the halo around it, creates the shank, adds the prong setting, and weighs the result — then shows you a render.
A finished, editable, parametric design appears in your viewport.
Every tool requires the RhinoArtisan plugin to be loaded with a valid license. If there’s a workflow you want your AI assistant to drive, tell us about it — real use cases decide what ships next.