This is the full list of tools an AI can call through AI connection (MCP). Tool names and argument names are written in English exactly as in the code. For setup, see AI connection (MCP).
| Marker | Meaning |
|---|
*argument | A required argument. |
| Read | Does not change the world. |
| Live | Works only while the editor is open (live mode). |
| 1 step | Recorded as one undo step. |
- Coordinates are in blocks: x = east, y = up, z = south.
min · max are the two corners of a box (both inclusive).
- Write blocks as
stone_bricks · oak_stairs[facing=east]. Missing properties use their defaults.
- Patterns mix by ratio, as in
70%stone,30%andesite, or use a height gradient with grad(y: a→b→c).
set_blocks · fill · shape · replace · transform · build · generate have an additional connect argument. It defaults to true and connects fences · glass panes · iron bars · walls · stair corners to their neighbors.- Many editing tools have a
name argument. It is the actor name shown in the Outliner.
| Tool | What it does | Main arguments |
|---|
status | Reports the mode (live/file) · open file · unsaved changes · block count · extent · selection · undo count · camera. Call it first. Read | — |
world_new | Opens a new empty world. Refuses if there are unsaved changes. | discard_unsaved |
world_open | Opens a .npworld file. Refuses if there are unsaved changes. | *path · discard_unsaved |
world_save | Saves as .npworld. If the name exists, appends _vN. | path · overwrite (current file only) |
undo · redo | Undo · redo (including user edits) | steps (1–50) |
actors | Actor list · delete · hide · show · select · rename · duplicate · move · transform · parent · new folder · lock · drop to ground. 1 step | *action · name · new_name · filter · offset · pos · rot · size · parent |
select | Sets or clears the editor selection box. | min · max · clear |
| Tool | What it does | Main arguments |
|---|
inspect_region | Box summary — block count · actual extent · count per layer · most common blocks. Read | *min · *max · top |
read_blocks | Reads the box’s blocks as layer-slice text art (up to 40,000 cells) or as a list (up to 6,000 entries). Read | *min · *max · format (slices · list) · axis |
surface | Shows the height and type of the top block in each column as text. Read | *min · *max · step |
find_blocks | Finds positions of blocks matching a condition (lantern · * and so on). Read | *match · min · max · limit |
block_search | Finds block ids by words (brick stairs). Read | *query · limit |
block_info | One block’s default state · properties and allowed values · same-material family · color · similar blocks. Read | *block |
palette | Pick blocks by color · similar blocks · block gradients. Requires the jar. Read | color · like · gradient · steps · count · include_slabs_stairs · face |
| Tool | What it does | Main arguments |
|---|
set_blocks | Places blocks cell by cell (up to 100,000 cells). 1 step | *blocks · state |
fill | Fills a box with a block or pattern (solid · hollow · walls only / overwrite · empty cells only · paint · erase). 1 step | *min · *max · pattern · form · mode · seed |
shape | Places a sphere · ellipsoid · cylinder · cone · pyramid · box · line · arch · slope (stairs). 1 step | *shape · pattern · at · anchor · radius · radii · height · size · axis · hollow · from · to · direction · stairs |
replace | Replaces matching blocks inside a box (the whole world by default). Actors are unchanged. 1 step | *from · *to · min · max · seed |
clear | Clears all blocks inside a box. 1 step | *min · *max |
transform | Moves · rotates · flips · stacks (arrays) · duplicates the blocks in a box. 1 step | *op · *min · *max · offset · quarters · axis · direction · count · gap · to |
build | Runs several edits in order as one step and one actor. On error, reverts everything. | *ops |
generate | Creates roofs · windows · doors · pillars · half-timbering · trees · rocks · terrain (islands · hills). 1 step | *kind · min · max · at · preset · settings · seed |
| Tool | What it does | Main arguments |
|---|
build_script | Builds walls · buildings · roofs (11 kinds) · towers · arches · bridges · paths and more with a JSON building program that has variables · loops · conditions · templates. 1 step | script · origin · rotate · mirror · seed · dry_run · help |
furnish | Decorates one room with furniture · lighting · decorations to suit its purpose and style. 1 step | *min · *max · *purpose · style · seed · dry_run |
furnish_building | Finds the rooms inside a building floor by floor and furnishes each one. 1 step | *min · *max · type · purposes · style · min_area · dry_run |
terrain_sculpt | Raises · lowers · flattens · smooths · terraces · adds noise · cliffs · paints existing ground with a brush · polygon · curved corridor · box. Skips building cells. 1 step | *op · center · radius · polygon · points · width · min · max · amount · height · strength · material · protect · dry_run |
| Tool | What it does | Main arguments |
|---|
terrain_water | Rivers · automatic rivers · lakes · waterfalls · coasts · filling enclosed pools. 1 step | *op · points · at · top · min · max · radius · width · depth · sea_level · fluid |
terrain_shape | Overhangs · erosion · caves · paths (cut and fill · bridges) · material rules · heightmap PNG export/import. 1 step | *op · min · max · at · radius · points · pattern · path · min_height · max_height |
scatter | Scatters trees · grass · flowers · rocks · props with spacing · density · slope · height conditions. 1 step | preset · items · min · max · at · radius · min_distance · density · max_slope · ground · seed |
props | Places · edits · duplicates · deletes custom model props with free transforms. 1 step | *action · model · id · pos · rot · scale · offset · actor · filter |
| Tool | What it does | Main arguments |
|---|
blueprints | Reports the buildable parts · arguments · styles · map spec format and examples. Read | section (all · parts · map_spec) |
place_blueprint | Builds one part (house · tower · hall · castle · path · plaza · fountain · portal · stall · well · street lamp · bridge · castle wall · grand staircase · tree · rock) on existing ground. 1 step | *blueprint · params · detail · style · seed |
build_map | Builds terrain → paths → structures → villages → nature in one go from a map spec (np-mapspec) (up to 1024×1024). 1 step | *spec · detail · style · review |
detail = low (masses only) · medium (normal architecture) · high (maximum vanilla detail) · max (high + decoration)style = medieval · fantasy_kingdom · nordic · desert
| Tool | What it does | Main arguments |
|---|
camera | Moves the editor camera or frames a box. Live | from · look_at · fov · frame_min · frame_max · view |
screenshot | Captures the viewport as an image and returns it. Read · Live | camera arguments + width · height · render (shader · raytraced · lit · unlit) · time_of_day |
map_image | Creates a top-down map image (height shading · water in blue). Works without the editor. Read | *min · *max · scale · grid |
view_image | Creates a CPU 3D rendered image (iso · top · oblique · side · eye level · close-up · custom camera). Works without the editor. Read | min · max · view · from · look_at · pos · heading · pitch · fov · zoom · width · height · outline · mark_min · mark_max · sun · shadows · exposure |
view_sheet | Creates one image of 4 iso directions (2×2). The fastest way to check all sides. Read | min · max · size · outline · sun · shadows |
| Tool | What it does | Main arguments |
|---|
shader_looks | Shows look presets (English id · name · all values) · saved looks · the current look · value names and ranges. Read | — |
shader_look | Views or changes the look. Merges partial values onto a preset. In live mode, the preview updates immediately. | preset · values · name · reset · save |
shader_formulas | Shows the list of shader functions (formulas) a look can change, and the default GLSL. Read | id |
build_shaderpack | Builds the NP Lite shader pack NP-Lite_<name>_vN.zip with the current look. | preset · values · name · folder |
build_resourcepack | Builds a complete resource pack <name>_rp_vN.zip + .sha1.txt + report from the registry. | name · folder · description · version_label · url · icon · allow_minecraft_namespace · server_registry · write_even_if_errors |
items | Shows registry entries (placement kind · item kind · item model · display · armor · effect). Read | filter |
item_set | Changes and saves one entry’s item kind · item model id · in-hand appearance · armor texture · effect frame. | *id · item_kind · item_model · display · armor · effect · allow_minecraft_namespace |
sky | Views, changes or resets sky customization (sun · moon · clouds). | *action (get · set · reset) · settings |
| Tool | What it does | Main arguments |
|---|
sounds | Lists sound events · file status · custom block sounds · synthesis recipes. Read | section · filter |
sound_set | Creates or changes one sound event (including replacing vanilla ones). | *id · files · add_files · replace · subtitle · remove |
sound_generate | Creates copyright-free sounds with the built-in synthesizer and registers them. recipe=starter_pack creates all starter sounds. | *recipe · seed · variants · event · namespace · mode · volume · replace_existing |
block_sounds_set | Sets a custom block’s break · place · step · hit · fall sounds. | *block · preset (stone · wood · crystal) · break · place · step · hit · fall · clear |
| Tool | What it does | Main arguments |
|---|
scene_rules | Shows the world logic rule list and checks, usable scene actors, and the fields (schema) of trigger · condition · action types. Read | section (actors · schema and so on) · id |
scene_rule_set | Creates · changes · deletes · reorders one rule. Also sets variables · enums · data types. Refuses on check errors. 1 step | rule · delete · index · force · variables · enums · types |
anim_clips | Shows the animation clip list and checks, and clip JSON. Read | id |
anim_clip_set | Creates · changes · deletes one clip (tracks · camera cuts · events · sounds · titles · fades). 1 step | clip · delete · force |
meta_actor | Creates · edits · deletes · duplicates actors without blocks (fog volume · look volume · sound emitter · scene actors trigger · spawn · display · text · light · camera · path · blocker). 1 step | *action · kind · name · at · preset · settings · offset |
actor_components | Adds · edits · removes · enables/disables actor components (trigger_volume · blocking_volume · interactable · sound_emitter · light · text_label · tags · logic). 1 step | *action · actor · type · component · props · replace |
| Tool | What it does | Main arguments |
|---|
bom | Bill of materials for a box · actor · world (item counts · stacks · shulkers) and raw material estimate. Read | min · max · actor · format · raw |
design_report | Marker design checks (region overlaps · spawn positions · warp links · buried/floating · naming rules), per-region content tables and planning tables. Read | format · sheet · lint · placement · fix_names |
travel_times | Straight-line distance, walking route and walk/run times between warps · player spawns · town centers. Read | walk · all_regions |
| Tool | What it does | Main arguments |
|---|
export | Exports the world (or a box) to a new folder as .schem · a Minecraft world folder (1.21.11). | *name · format (schem · world · both) · min · max · spawn · game_mode · biome · time · folder |
| Tool | What it does | Main arguments |
|---|
world_info | World summary JSON for viewer programs (list of 16³ sections · edition · actor boxes · scene actors). Read | sections · min · max · actors · catalog |
world_chunks | 16³ section block data (palette + packed array) JSON. Read | sections · min · max · near · max_sections · max_bytes |