metashape-mcp

Diagnoses alignment failures and poor results in Metashape. When alignment rates are low, cameras fail to align, reprojection errors are high, or drift is detected, this agent investigates the cause and prescribes specific fixes. Not a QA checker (that's photogrammetry-qa) — this is the troubleshooter you call when something is already wrong.

Advises on ground control point strategy for corridor photogrammetry. Analyzes drift patterns to recommend WHERE to place GCPs, how many are needed, what accuracy to set, and how to use road markings as natural control points. Also handles marker error analysis and DEM-based virtual checkpoints.

Orchestrates the Metashape-to-Blender handoff for terrain tile workflows. Handles PLY/OBJ export from Metashape, import into Blender, coordinate system verification, tile naming conventions, and validates that tiles loaded correctly with proper transforms. Bridges the gap between the two MCP servers.

Cross-references MCP tool implementations against api_reference.txt to catch parameter mismatches, wrong defaults, missing options, and incorrect enum mappings. Use after modifying tools or when auditing tool correctness.

Quality assurance reviewer for Metashape processing. Checks alignment rates, reprojection errors, tie point counts, and mesh statistics against known-good thresholds after major processing steps. Use after alignment, tie point filtering, dense reconstruction, or mesh building.

Provides a quick status overview of a Metashape+Blender photogrammetry project and recommends what to do next. Reads project state from both MCP servers, identifies what stages are complete, what is in progress, and what the next logical step is. Use for orientation at the start of a session or when unsure what state a project is in.

Blender-side terrain mesh processing agent. Handles canopy/artifact removal, surface classification (road, rock face, vegetation), UV projection, mesh cleanup, and game-ready optimization. Makes decisions about WHICH tiles need processing and HOW aggressively to clean them. Works through the Blender MCP server.

Advises on texture atlas settings, diagnoses texture artifacts (seams, blur, ghosting, color shifts), and recommends blending modes for specific use cases. Helps choose between mosaic (sharp) and natural (seamless) based on the content and output target. Not a processing agent — it makes the decisions, then tells you which tool calls to make.

Export all available products from the current Metashape project — point cloud, model, DEM, orthomosaic, tiled model, report, and cameras. Skips unavailable products automatically.

Orchestrate incremental alignment of long road corridor captures with automatic drift detection and QA gates. Prevents alignment divergence by checking GPS deviation gradients and continuity between batches. Works through the Metashape MCP server.

Diagnose alignment quality issues in the current Metashape project — checks camera alignment rate, tie point density, reprojection error, and sensor calibration. Provides actionable fix recommendations.

Scaffold a new Metashape MCP tool with correct imports, registration, progress tracking, and auto-save patterns. Use when adding new tools to the metashape-mcp server.

Look up Metashape Python API parameters and enums from local reference files when building or fixing MCP tools. Use when you need to verify parameter names, types, defaults, or enum values for Metashape API calls.

Guide dense reconstruction, mesh building, and texturing in Metashape MCP. Covers depth maps, point cloud, mesh, texture, DEM, and orthomosaic generation with correct GPU/CPU settings and quality parameters. Works through the Metashape MCP server.

Set up a new Metashape project from scratch — import photos, load GPS reference, configure sensors (fisheye, rolling shutter, multi-camera), import EXR alpha masks, run image quality analysis, and disable bad frames. The first skill to use on any new capture. Works through the Metashape MCP server.

Recommend optimal Metashape processing settings based on dataset size and available RAM. Provides specific parameter values for each processing step with quality/speed trade-offs.

Prevent and remove sky/tunnel mesh artifacts in road corridor photogrammetry. Covers five strategies from Metashape-side prevention (height field, region crop, point cloud classification, source selection) to post-mesh cleanup. The

Guide UV mapping, texture atlas generation, color calibration, and texture quality optimization in Metashape MCP. Covers blending modes, ghosting filter, texture size selection by use case, and diagnosing common texture artifacts. Works through the Metashape MCP server.

Export terrain tiles from Blender to game-ready FBX with correct transform, scale, and axis settings. Covers the full pipeline from photogrammetry mesh through Blender cleanup to FBX export via Blender MCP.

Download USGS 3DEP LiDAR DEM data, colorize with satellite imagery, and import into Metashape as laser scan ground truth. Use when extending photogrammetry environments with surrounding terrain.

6 hooks across 2 events