Plutocalc Designer

You can access Plutocalc Designer’s MCP server to interact with water and wastewater treatment design tools through a standardized MCP interface. This enables your AI applications to list models, fetch input templates, run calculations, and retrieve model information using a consistent HTTP endpoint.

How to use

To use this MCP server with your MCP-compatible client, connect to the designated MCP URL and begin discovering available models and templates. You can list models, fetch input templates for a specific model, view model manuals, convert between JSON templates and Markdown, and run calculations directly from your AI workflow. Use natural language prompts in your AI assistant to request information like the available wastewater treatment models or the input template for a chosen design.

How to install

Prerequisites: make sure you have Node.js and npm installed on your machine. You will also need access to an MCP client compatible with MCP servers.

Install and run the MCP server locally using the following steps.

# Clone the repository
 git clone https://github.com/danpeig/plutocalcdesigner-mcp.git
cd plutocalcdesigner-mcp

# Install dependencies
npm install

# Start the MCP server
npm start

Configuration and connection details

You can connect to this MCP server via HTTP at the provided MCP URL. If your client requires manual configuration, you can specify the server URL and transport type as shown in the example configuration.

{
  "mcpServers": {
    "plutocalcdesigner": {
      "url": "https://www.plutocalc.com/designer/mcp",
      "transport": "http"
    }
  }
}

Documentation and model access

The MCP server exposes a set of tools to interact with Plutocalc Designer models. You can list available models, get detailed information about a model, retrieve input templates, view model manuals, convert templates between formats, and execute calculations. For programmatic access, you can also retrieve the OpenAPI specifications to understand available endpoints and request formats.

Notes and tips

Available tools

server_version

Get the server version string for Plutocalc Designer MCP server

server_status

Get the current status of the MCP server

license_status

Check license credits balance (requires a licenseKey)

list_models

List all available calculation models

list_models_info

List models with detailed information including manuals (recommended starting point)

get_model

Get model name and version (requires model)

get_model_information

Get detailed information about a model (requires model)

get_model_template

Get the calculation input template for a model (requires model)

get_model_referencedb

Get reference database entries for a model (requires model)

get_model_unitslist

Get supported units for a model (requires model)

compute_model

Run model calculation (requires model and input)

json_to_markdown

Convert model JSON template to Markdown format (requires model and input)

markdown_to_json

Convert Markdown template back to JSON (requires model and input)

model_manual

Get the URL to the model help/manual page (requires model)

license_help

Get information about license key requirements