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