3D Mesh Optimizer MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@3D Mesh Optimizer MCPdecimate this 2M-poly mesh to 200k and Draco-compress it to GLB"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
3D Mesh Optimizer MCP
Automated 3D mesh decimation, Draco compression, watertight manifold auditing, and exact CSG booleans for WebGL and spatial agents.
Built specifically for Three.js, Babylon.js, WebGL developers, game asset pipelines, and 3D spatial computing agents.
⚡ Quickstart
Smithery Install
smithery skill add whambammy/spatial-mesh-optimizer-mcpClaude Desktop / Cursor (claude_desktop_config.json)
{
"mcpServers": {
"spatial-mesh-optimizer-mcp": {
"command": "npx",
"args": ["-y", "@whambammy/spatial-mesh-optimizer-mcp"],
"env": {
"PAYMENT_WALLET": "0x9793E7269b3301893318dEa8338576Ba612F39B3",
"BASE_RPC_URL": "https://mainnet.base.org"
}
}
}
}Related MCP server: ligeia-mcp-server
🛠️ Included Tools
Tool Name | Price (USDC) | Capability |
| $0.05 | Bakes normal maps, decimates polycount, Draco-compresses GLTF models for 3D web engines and spatial metaverses. |
| $0.050 | Exact arbitrary-precision constructive solid geometry (CSG) mesh boolean operations (Union, Difference, Intersection) that resolve coplanar facets without crashing. |
| $0.035 | Audits 3D geometry for non-manifold edges, T-junctions, duplicate vertices, flipped surface normals, and boundary holes before simulation or 3D fabrication. |
| $0.040 | Simplifies dense 3D meshes using Quadric Error Metrics (QEM), reducing polycounts by 50-90% while preserving silhouettes, UV borders, and vertex normals. |
| $0.035 | Applies Draco geometry quantization and Meshopt encoding to glTF/GLB assets, reducing file payload by up to 85% for real-time spatial streaming. |
🔄 End-to-End Workflow
An agent receives a raw CAD/OBJ model -> audits manifold watertightness -> applies exact CSG difference to carve out mounting holes -> decimates polygon count by 75% -> exports a web-ready Draco-compressed GLTF.
💰 The x402 Base L2 Micropayment Protocol
When an agent invokes a tool without payment, the server responds with a deterministic HTTP 402 Payment Required challenge containing:
Target tool price in USDC
Base Native USDC Contract:
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913Recipient payout wallet address
Single-use cryptographic nonce
Once broadcasted on Base L2, resubmitting with paymentSignature unlocks deterministic execution.
📄 License
MIT License. Created by Whambammy.
Available Tools
5 toolsgltf_draco_mesh_quantizerB
Applies Draco geometry quantization and Meshopt encoding to glTF/GLB assets, reducing file payload by up to 85% for real-time spatial streaming. (0.035 USDC on Base L2)
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Input parameters or JSON string payload for the tool execution | |
| paymentSignature | No | Base L2 USDC micropayment signature or transaction hash for x402 settlement |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the encoding operations but does not disclose whether the input asset is mutated or a new asset is returned, whether the operation is reversible, or any side effects such as texture loss or format changes. The payment mention (0.035 USDC) hints at a paid service but does not clarify authentication or rate limits. This is a significant gap for a processing tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences, front-loading the core function and the use context. The cost note is appended as a separate sentence and does not clutter the main purpose. It is efficient and avoids redundancy, though the payment detail could be considered optional. Overall, it is concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (mesh processing with a payment requirement) and the absence of an output schema, the description is incomplete. It does not explain what the tool returns (e.g., compressed asset, metadata), what input format is expected (binary vs. text), or how the payment signature is used. An agent cannot reliably construct a correct call without additional context. The schema is generic and the description does not bridge the gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (both parameters have descriptions), so the baseline is 3. However, the description adds no additional meaning about the parameters. The payload description is generic ('Input parameters or JSON string payload') and the tool name suggests it expects glTF/GLB data, but the description does not specify the payload format (e.g., base64, binary, path) or required fields. It does not compensate for the schema's vagueness, but since the schema is present, the score stays at the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific verb ('Applies'), a specific resource ('Draco geometry quantization and Meshopt encoding'), and the target asset type ('glTF/GLB assets'). It also communicates the benefit (payload reduction) and the use context (real-time spatial streaming). This differentiates it from siblings like optimize_3d_mesh (general optimization) and convert_gltf_to_obj (format conversion) without requiring schema inspection.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions a use case ('real-time spatial streaming') but does not explicitly state when to use this tool versus alternatives such as optimize_3d_mesh or validate_gltf_structure. It lacks guidance on prerequisites, input format restrictions, or when not to use it. The agent is left to infer that this is the right tool for Draco/Meshopt encoding, but no explicit routing or exclusions are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mesh_boolean_csg_exactB
Exact arbitrary-precision constructive solid geometry (CSG) mesh boolean operations (Union, Difference, Intersection) that resolve coplanar facets without crashing. (0.050 USDC on Base L2)
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Input parameters or JSON string payload for the tool execution | |
| paymentSignature | No | Base L2 USDC micropayment signature or transaction hash for x402 settlement |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose behavior itself; it reveals exact arbitrary-precision math, coplanar-face handling that avoids crashes, and a 0.050 USDC Base L2 cost. However, it does not disclose input/output format, side effects, failure modes, or precision limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single front-loaded sentence with dense, non-redundant information; every clause advances the value, including the cost. No filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a complex geometry tool with no output schema and no annotations, the description omits the minimal payload contract (mesh format, operand count, operation selection) and return semantics. An agent would have to guess the JSON structure to invoke it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Both parameters are described in the schema (100% coverage), so the baseline applies; the description adds domain intent but no payload syntax. It never explains how to encode the two meshes and an operation into the required payload string, nor what paymentSignature must contain beyond the schema's generic text.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description names the exact operation: arbitrary-precision CSG mesh boolean operations with Union, Difference, and Intersection, and highlights coplanar-facet robustness. This clearly separates it from geometric siblings like optimize_3d_mesh, mesh_decimate_quadric_simplifier, and mesh_convex_hull_quickhull, none of which perform CSG booleans.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit when-to-use or when-not-to-use guidance is provided, and no alternative tool is referenced. The use case must be inferred from the operation names; the description never says which sibling to prefer for approximating vs. exact booleans.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mesh_decimate_quadric_simplifierA
Simplifies dense 3D meshes using Quadric Error Metrics (QEM), reducing polycounts by 50-90% while preserving silhouettes, UV borders, and vertex normals. (0.040 USDC on Base L2)
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Input parameters or JSON string payload for the tool execution | |
| paymentSignature | No | Base L2 USDC micropayment signature or transaction hash for x402 settlement |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden. It discloses the algorithm (QEM), the reduction range, and what is preserved, which is useful. However, it does not mention whether the operation is destructive, whether it modifies the input or returns a new mesh, or any side effects. The pricing note (0.040 USDC) is context but not behavioral.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, information-dense sentence that front-loads the core function and key benefits. The pricing note is a minor addition that could be considered extraneous but does not harm clarity. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a mesh-processing tool with no output schema and no annotations, the description gives a good high-level overview but lacks critical operational details: input mesh format, output format, whether the operation is destructive, and how to specify reduction parameters. The sibling list shows many mesh tools, so more specificity about input/output would help an agent select and invoke it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for the two parameters, but the descriptions are generic ('Input parameters or JSON string payload'). The tool description does not explain what fields the payload should contain (e.g., mesh format, target polycount, preserve borders). With 100% coverage, baseline is 3, and the description adds no specific parameter guidance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool simplifies dense 3D meshes using Quadric Error Metrics, with specific outcomes (reducing polycounts by 50-90%, preserving silhouettes, UV borders, and vertex normals). This distinguishes it from siblings like optimize_3d_mesh, mesh_subdivision_loop_surface, and mesh_watertight_manifold_auditor.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for dense meshes needing polycount reduction, but does not explicitly state when to use this tool versus alternatives like optimize_3d_mesh or gltf_draco_mesh_quantizer. It mentions preservation of UV borders and normals, which hints at suitability for textured models, but no explicit exclusions or alternative routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mesh_watertight_manifold_auditorA
Audits 3D geometry for non-manifold edges, T-junctions, duplicate vertices, flipped surface normals, and boundary holes before simulation or 3D fabrication. (0.035 USDC on Base L2)
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Input parameters or JSON string payload for the tool execution | |
| paymentSignature | No | Base L2 USDC micropayment signature or transaction hash for x402 settlement |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the burden of explaining behavior. It does disclose the inspection scope and cost, and 'audits' implies a non-mutating operation, but it does not state whether it returns a pass/fail verdict, a detailed report, or how failures are represented. This leaves some behavioral ambiguity.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One dense sentence front-loads the action and audit scope, followed by a short cost parenthetical that is relevant to a paid tool. There is no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, so the absence of any description of return behavior is a real gap. The generic payload parameter also lacks guidance on which mesh representation (OBJ, GLTF, etc.) is expected, leaving an agent uncertain how to construct a valid call.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so both payload and paymentSignature are described at least generically in the schema. The description adds no detail about the expected geometry format inside the JSON payload, so it does not improve on the schema baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description uses a specific verb ('Audits') with a clear resource (3D geometry) and enumerates concrete defect categories, making its function obvious. It also names the intended stage ('before simulation or 3D fabrication'), which distinguishes it from sibling tools like optimize_3d_mesh that modify geometry rather than inspect it.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'before simulation or 3D fabrication' gives a clear contextual trigger for when to run the audit. It does not explicitly name alternatives or exclusions, but the inspection-vs-repair distinction is strongly implied by the sibling set.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
optimize_3d_meshA
Bakes normal maps, decimates polycount, Draco-compresses GLTF models for 3D web engines and spatial metaverses. (0.05 USDC on Base L2)
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Input parameters or JSON string payload for the tool execution | |
| paymentSignature | No | Base L2 USDC micropayment signature or transaction hash for x402 settlement |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description bears full responsibility. It does disclose a meaningful trait — the 0.05 USDC Base L2 cost — which adds value beyond the schema's bare paymentSignature param. But it stays silent on input format, output shape, and whether the operation mutates or returns new files, leaving the agent to guess the execution contract.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two efficient sentences: the first front-loads all three operations and the target, the second tucks the cost into a parenthetical. Zero filler — every word contributes, and the cost note is placed where it won't distract from the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a three-operation tool with no annotations and no output schema, the description covers purpose and cost but omits input/output specifics and the payment flow (when the signature is required relative to execution). An agent could call it but without knowing what the payload should contain or what result to expect, completeness is only partial.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (payload and paymentSignature both documented). The description's cost disclosure enriches paymentSignature with the amount, but it adds nothing about payload structure or expected GLTF representation. Baseline 3 holds since the schema already handles parameter documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names three concrete operations (bake normal maps, decimate polycount, Draco-compress) applied to a specific resource (GLTF models) with a clear target audience (3D web engines, spatial metaverses). This distinctly positions it as the all-in-one optimizer versus siblings like mesh_decimate_quadric_simplifier and gltf_draco_mesh_quantizer, which handle single steps.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for 3D web engines and spatial metaverses' gives target context, implying when this general optimizer fits. However, it offers no explicit routing guidance or exclusions — with dozens of specialized 3D siblings (obj_mtl_to_glb_packer, convert_gltf_to_obj, mesh_decimate_quadric_simplifier), an agent gets no help choosing between the combined tool and the focused alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
5 tool updates
v1.0.0- First observed
gltf_draco_mesh_quantizer - First observed
mesh_boolean_csg_exact - First observed
mesh_decimate_quadric_simplifier - First observed
mesh_watertight_manifold_auditor - First observed
optimize_3d_mesh
TDQS
Scored across 5 tools
optimize_3d_mesh is described as baking normal maps, decimating polycount, AND Draco-compressing GLTF — directly overlapping with mesh_decimate_quadric_simplifier and gltf_draco_mesh_quantizer. An agent cannot easily tell when to use the bundled pipeline versus the specialized tools. The boolean and audit tools are clearly distinct.
Three tools follow a mesh_<noun> noun-led pattern (mesh_boolean_csg_exact, mesh_watertight_manifold_auditor, mesh_decimate_quadric_simplifier), but optimize_3d_mesh is verb-led and gltf_draco_mesh_quantizer is prefixed by format. Readable but inconsistent conventions.
Five tools is well-scoped for a focused 3D mesh optimization domain, with each core capability (boolean, audit, decimate, compress, bundled optimize) earning its place. No bloat or thinness.
Covers optimization, decimation, compression, CSG, and auditing, but the auditor only detects problems — there is no repair/cleanup tool to fix non-manifold edges or holes. Format conversion and LOD generation are also absent, though agents can work around these.
Maintenance
Related MCP Connectors
Gamedev tools for AI agents: level design, renders, sprites, GLB optimizer. Pay per call with x402.
x402-paid tools: text to 3D-printable STL, web search, and search+read. USDC on Base.
63 pay-per-call tools for agents: vision, text, data, web, blockchain. USDC on Base via x402.
Pay-per-call tools for autonomous agents, settled in USDC on Base via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables processing, validation, optimization, and analysis of 3D models with glTF/GLB support, including format conversion, compression (Meshopt/Draco), texture optimization, and detailed model statistics.17 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to discover and invoke x402-monetized computational engines for media geometry, measurements, JSON hygiene, and ComfyUI preflight audits, with USDC settlement on Base Mainnet.-
- AlicenseAqualityCmaintenanceEnables AI agents and MCP clients to perform 3D asset creation and verification: exact b-rep CAD, GLB validation with embedded certificates, mesh inspection, and physics scenes, with most tools running without Blender.3648 npmMIT

wham-engineofficial
AlicenseCqualityCmaintenanceProvides AI agents with 200 deterministic micro-services covering code auditing, 3D/robotics, media processing, cryptography, blockchain settlement, AI safety, networking, and math, with automatic x402 USDC micropayments.200MIT