calcslive_calculate

Instructions

Implementation Reference

• src/index.ts:190-234 (handler)

  Executes the calcslive_calculate tool by POSTing articleId, inputs, and outputs to the CalcsLive API calculate endpoint, then returns the formatted calculation result or error.

  if (request.params.name === "calcslive_calculate") {
    const { articleId, inputs, outputs = {} } = request.params.arguments as any;
  
    try {
      const response = await fetch(`${CALCSLIVE_API_BASE}/api/v1/calculate`, {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          articleId,
          apiKey: API_KEY,
          inputs,
          outputs
        }),
      });
  
      if (!response.ok) {
        const errorData = await response.json() as any;
        throw new Error(errorData.error?.message || `API error: ${response.status}`);
      }
  
      const result = await response.json() as any;
  
      // Format response for MCP
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(result.data.calculation, null, 2),
          },
        ],
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text",
            text: `Error performing calculation: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:52-96 (registration)

  Registers the calcslive_calculate tool in the ListTools response, including name, description, and detailed inputSchema for articleId, inputs (with value/unit), and optional outputs.

  {
    name: "calcslive_calculate",
    description: "Perform unit-aware engineering calculations using CalcsLive articles. Automatically handles unit conversions and dependency calculations. Example: Calculate hydro power with flow rate 150 m³/s and head 25m. Returns calculated outputs with values and units.",
    inputSchema: {
      type: "object",
      properties: {
        articleId: {
          type: "string",
          description: "Article Short ID (e.g., 'pump-calc-abc'). Use calcslive_validate to discover available articles."
        },
        inputs: {
          type: "object",
          description: "Input PQ values with units. Example: {velocity: {value: 25, unit: 'm/s'}, mass: {value: 1500, unit: 'kg'}}",
          additionalProperties: {
            type: "object",
            properties: {
              value: {
                type: "number",
                description: "Numeric value for this input"
              },
              unit: {
                type: "string",
                description: "Unit for this value (e.g., 'm/s', 'kg', 'kW'). Supports both superscript (m³) and caret (m^3) notation."
              }
            },
            required: ["value", "unit"]
          }
        },
        outputs: {
          type: "object",
          description: "Optional output unit preferences. Example: {distance: {unit: 'km'}}",
          additionalProperties: {
            type: "object",
            properties: {
              unit: {
                type: "string",
                description: "Desired output unit (optional)"
              }
            }
          }
        }
      },
      required: ["articleId", "inputs"]
    }
  },

• src/index.ts:55-95 (schema)

  Input schema definition for the calcslive_calculate tool, specifying structure for articleId, inputs as objects with value and unit, and optional outputs.

  inputSchema: {
    type: "object",
    properties: {
      articleId: {
        type: "string",
        description: "Article Short ID (e.g., 'pump-calc-abc'). Use calcslive_validate to discover available articles."
      },
      inputs: {
        type: "object",
        description: "Input PQ values with units. Example: {velocity: {value: 25, unit: 'm/s'}, mass: {value: 1500, unit: 'kg'}}",
        additionalProperties: {
          type: "object",
          properties: {
            value: {
              type: "number",
              description: "Numeric value for this input"
            },
            unit: {
              type: "string",
              description: "Unit for this value (e.g., 'm/s', 'kg', 'kW'). Supports both superscript (m³) and caret (m^3) notation."
            }
          },
          required: ["value", "unit"]
        }
      },
      outputs: {
        type: "object",
        description: "Optional output unit preferences. Example: {distance: {unit: 'km'}}",
        additionalProperties: {
          type: "object",
          properties: {
            unit: {
              type: "string",
              description: "Desired output unit (optional)"
            }
          }
        }
      }
    },
    required: ["articleId", "inputs"]
  }