calcslive_calculate
Perform unit-aware engineering calculations with automatic unit conversions and dependency resolution using CalcsLive articles. Input values with units to get calculated outputs.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| articleId | Yes | Article Short ID (e.g., 'pump-calc-abc'). Use calcslive_validate to discover available articles. | |
| inputs | Yes | Input PQ values with units. Example: {velocity: {value: 25, unit: 'm/s'}, mass: {value: 1500, unit: 'kg'}} | |
| outputs | No | Optional output unit preferences. Example: {distance: {unit: 'km'}} |
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"] }