mcp-math-tools

Math and calculation tools for AI agents, exposed via the Model Context Protocol (MCP).

Tools

`calculate`

Evaluate math expressions safely (no eval). Supports arithmetic operators (+, -, *, /, ^, %), parentheses, functions (sqrt, abs, floor, ceil, round, log, ln, sin, cos, tan, min, max, pow), constants (pi, e), and named variables.

`convert_units`

Convert between units across six categories:

Length: m, km, cm, mm, mi, yd, ft, in
Weight: kg, g, mg, lb, oz, ton
Temperature: C, F, K
Data: B, KB, MB, GB, TB
Time: s, min, h, d, week
Speed: m/s, km/h, mph, knots

`statistics`

Statistical analysis on datasets: mean, median, mode, variance, standard deviation, min, max, range, percentile, correlation between two arrays, and a full summary mode.

`format_number`

Format numbers as: currency ($1,234.56), percentage, scientific notation, binary, octal, hexadecimal, significant figures, or with thousands separators.

`percentage_calc`

Common percentage operations: X% of Y, what percent X is of Y, percentage change between two values, tip calculator, discount calculator, and markup calculator.

Installation

bash

npm install
npm run build

Usage with Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "math-tools": {
      "command": "node",
      "args": ["path/to/mcp-math-tools/dist/index.js"]
    }
  }
}

Examples

Calculate: 2 * (3 + 4) ^ 2 returns 98

Convert: 100 from km/h to mph returns 62.137...

Statistics: summary of [1, 2, 3, 4, 5] returns mean, median, mode, variance, etc.

Format: 1234567.89 as currency returns $1,234,567.89

Percentage: 15% tip on 85.50 bill split 3 ways

License

MIT

io.github.rog0x/math