# mcp-math-tools

Math and calculation tools for AI agents, exposed via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).

## 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