io.github.printplan3d/ritn3d-mcp

Official registry Other

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).

PYPI package ritn3d-mcp
Claude Code
claude mcp add ritn3d-mcp -- python ritn3d-mcp==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "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
  1. ritn3d-mcp
  2. Install
  3. Use with Claude Desktop
  4. Use with Claude Code
  5. Tools exposed
  6. Resources exposed
  7. Example agent flow
  8. What this server does NOT do
  9. Source
  10. License

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

ToolDescription
validate_floor_plan_imagePre-flight check on a floor plan image (format, dimensions, warnings) before sending to Ritn3D
estimate_complexityHeuristic complexity score (simple / moderate / complex) based on edge density
estimate_render_timeRough low/expected/high render-time range for a given complexity
get_share_link_metadataFetch public page title + OpenGraph data from a Ritn3D share URL
validate_glbSanity-check a downloaded GLB file (magic header, version, chunks)
convert_unitsUnit conversion with optional model scale factor (1:100, 1:50, etc.)
get_capabilitiesReturns Ritn3D's supported inputs, outputs, accuracy by input type, and pricing
get_pricingReturns current Ritn3D pricing tiers in USD
get_failure_modesReturns structured list of known failure modes with mitigation tips

Resources exposed

URIContent
ritn3d://capability-cardMachine-readable summary of what Ritn3D does, accuracy, pricing
ritn3d://failure-playbookCommon 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.