Rofilter

What rofilter does

rofilter exposes ROFilter’s reverse-osmosis design functions through MCP. The remote service at rofilter.cn provides a membrane library containing 742 elements from eight brands, water-quality calculations, scaling analysis, system design, and industry-specific scheme templates. AI clients can use these functions to compare membrane elements, interpret feed-water data, assess operating constraints, or calculate a proposed system.

The available operations are:

• list_elements searches the membrane catalog by brand, family, keyword, or TDS range. Results support pagination, with an option to return the full catalog.
• get_element returns the full specifications and operating limits for one membrane.
• analyze_water calculates TDS, conductivity, osmotic pressure, LSI, Ryznar, CCPP, carbonate balance, and salt saturation values.
• analyze_scaling evaluates scaling risk, sustainable maximum recovery, limiting minerals, antiscalant scenarios, recovery-rate checks, antiscalant recommendations, and pH scans.
• run_design calculates a complete multi-stage system, including feed pressure, product-water TDS, energy use, stage flux, and pressure drop.
• list_schemes lists templates for power, pharmaceutical, electronics, food and beverage, and seawater desalination applications.

Lookup and assessment operations are free. run_design is metered and includes a daily free allowance.

How it works

The package offers two connection modes. In stdio mode, the rofilter-mcp executable starts a local bridge that forwards MCP initialization, tool discovery, and tool calls to ROFilter’s Streamable HTTP endpoint. The bridge maintains the MCP session identifier and handles JSON and SSE responses. It uses Node’s built-in fetch, so the package has no runtime dependencies.

Remote clients can instead connect directly to https://rofilter.cn/mcp using Streamable HTTP. HTTP requests authenticate with a Bearer token, while the local bridge reads the token from its environment. Both modes use the calculation service hosted by rofilter.cn, and the results are intended to match the ROFilter web application.

Setup and configuration

For local MCP clients, configure a server with npx -y rofilter; the equivalent binary name is rofilter-mcp. Node.js 18 or newer is required. A token is optional for the shared trial access, but a personal token can be generated from the ROFilter account settings under MCP access.

Example stdio configuration:

{
  "mcpServers": {
    "rofilter": {
      "command": "npx",
      "args": ["-y", "rofilter"],
      "env": { "ROFILTER_TOKEN": "rfmcp_your_token" }
    }
  }
}

For direct HTTP access, use https://rofilter.cn/mcp and send Authorization: Bearer rfmcp_your_token. The repository also contains Agent Skill packages in standard nested and flat layouts. These provide workflow guidance and reference material, but the MCP connection still needs to be configured in the client.

Tools and capabilities

The membrane catalog can be narrowed by manufacturer, product family, search term, or TDS suitability, then read in pages or retrieved in full. Water analysis covers both common feed-water indicators and less basic chemistry, including carbonate equilibrium and mineral saturation. Scaling analysis compares operation with and without antiscalant and can scan pH to identify a preferred value and acid or alkali dosing.

System design covers multiple stages and reports hydraulic and quality outputs together, including inlet pressure, permeate TDS, energy consumption, per-stage flux, and pressure loss. Scheme templates provide starting points for several industrial sectors. These capabilities make the server suitable for conversational design checks, preliminary sizing questions, and structured comparisons of membrane choices.

Limitations and notes

run_design is the metered operation, while query and assessment tools are free within the service’s access rules. The package includes shared trial access with a daily allowance; production or higher-volume use should use a personal token. Calculations come from the same engine as the ROFilter web application, but designs should be checked against the manufacturer’s official software before delivery.

The stdio package is a bridge to the hosted service rather than a standalone offline calculation engine. Direct HTTP use also requires network access to rofilter.cn. Keep tokens in client environment settings or request headers rather than placing them in prompts or source files.