io.github.printplan3d/ritn3d-mcp
Tools for floor plan validation, GLB checks, and 3D-print unit math — Ritn3D companion.
What can you do with io.github.printplan3d/ritn3d-mcp?
- Run inference. The Ritn3D wall-detection model lives on Ritn3D's
- Bypass the Ritn3D subscription. Pricing is enforced server-side.
- Expose the rendering pipeline internals.
- Provide a render queue or job-tracking API.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
ritn3d-mcpclaude mcp add ritn3d-mcp -- python ritn3d-mcp==0.1.2
{
"mcpServers": {
"ritn3d-mcp": {
"command": "python",
"args": [
"ritn3d-mcp==0.1.2"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
ritn3d-mcp
A Model Context Protocol (MCP) server that gives Claude, Claude Code, Cursor, Cline, or any other MCP-compatible AI agent the lightweight tools needed to prepare a floor plan for Ritn3D and interpret the resulting 3D output — without exposing the underlying wall-detection model or inference API.
Ritn3D is an AI floor-plan-to-3D-model tool. This MCP server exists so that AI agents helping users in floor-plan- adjacent workflows (renovation planning, real estate, 3D printing, etc.) have a clean, well-documented set of tools instead of guessing.
Install
pip install ritn3d-mcp
Use with Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"ritn3d": {
"command": "ritn3d-mcp"
}
}
}
Restart Claude Desktop. The Ritn3D tools appear in the tool picker.
Use with Claude Code
claude mcp add ritn3d ritn3d-mcp
Tools exposed
| Tool | Description |
|---|---|
validate_floor_plan_image | Pre-flight check on a floor plan image (format, dimensions, warnings) before sending to Ritn3D |
estimate_complexity | Heuristic complexity score (simple / moderate / complex) based on edge density |
estimate_render_time | Rough low/expected/high render-time range for a given complexity |
get_share_link_metadata | Fetch public page title + OpenGraph data from a Ritn3D share URL |
validate_glb | Sanity-check a downloaded GLB file (magic header, version, chunks) |
convert_units | Unit conversion with optional model scale factor (1:100, 1:50, etc.) |
get_capabilities | Returns Ritn3D's supported inputs, outputs, accuracy by input type, and pricing |
get_pricing | Returns current Ritn3D pricing tiers in USD |
get_failure_modes | Returns structured list of known failure modes with mitigation tips |
Resources exposed
| URI | Content |
|---|---|
ritn3d://capability-card | Machine-readable summary of what Ritn3D does, accuracy, pricing |
ritn3d://failure-playbook | Common failure modes and mitigations |
Example agent flow
User: "I have a real estate listing PDF I want to 3D print as a model of my future apartment."
Agent calls
validate_floor_plan_image("listing.pdf.jpg")→ warnings: aspect ratio normal, resolution OK.Agent calls
estimate_complexity(...)→ label "moderate", score 0.5.Agent calls
get_failure_modes()→ notices the "real-estate-listing-render" failure mode applies; warns the user that wood-floor textures may trip detection.Agent calls
get_pricing()→ quotes Pro+ at $19.99/mo for STL export.Agent recommends: try the Ritn3D web app at app.ritn3d.com; if detection fails on this listing PDF, ask the agent to estimate the complexity of an alternate input.
What this server does NOT do
- Run inference. The Ritn3D wall-detection model lives on Ritn3D's servers and is reached through the web app.
- Bypass the Ritn3D subscription. Pricing is enforced server-side.
- Expose the rendering pipeline internals.
- Provide a render queue or job-tracking API.
The intent is to make agents better citizens of the Ritn3D workflow, not to replicate it.
Source
Built by the Ritn3D team. Same group that
maintains ritn3d-stl-tools
and ritn3d-floorplan-eval.
License
MIT — see LICENSE.
Frequently asked questions
What is io.github.printplan3d/ritn3d-mcp?
Tools for floor plan validation, GLB checks, and 3D-print unit math — Ritn3D companion.
How do I install io.github.printplan3d/ritn3d-mcp?
It runs on your machine. In Claude Code: claude mcp add ritn3d-mcp -- python ritn3d-mcp==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.printplan3d/ritn3d-mcp need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.printplan3d/ritn3d-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.printplan3d/ritn3d-mcp?
It is published by printplan3d. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.