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

npm install
npm run build

Usage with Claude Desktop

Add to your claude_desktop_config.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