# Complex Math Tool

## Links

- Product page URL: https://www.agentpmt.com/marketplace/complex-math-tool
- Product markdown URL: https://www.agentpmt.com/marketplace/complex-math-tool?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/complex-math-tool?format=agent-json

## Overview

- Product ID: 694ecf2fcca5b5123ad00c32
- Vendor: Apoth3osis
- Type: core utility
- Unit type: request
- Price: 500 credits
- Categories: Scientific Computing, Financial Modeling, Mathematical Computing
- Generated at: 2026-04-15T18:25:09.964Z

### Page Description

A utility for common mathematical calculations frequently needed in business, finance, data analysis, and everyday applications. It provides comprehensive percentage operations including calculating what percent one value is of another, finding a percentage of a given number, and determining percent increase or decrease between two values for tracking growth or decline metrics. Ratio calculation simplifies proportions between multiple numbers by finding the greatest common divisor and reducing to the smallest whole number representation. Number rounding supports configurable decimal precision from 0 to 10 places for formatting financial figures, measurements, and display values. Random number generation produces both floating-point values with specified decimal precision and integers within defined minimum and maximum bounds for sampling, testing, and simulation purposes. Aggregate functions operate on arrays of numbers to calculate sums, arithmetic averages, and identify minimum and maximum values with their array positions. The greatest common divisor function finds the largest integer that evenly divides all numbers in a set, useful for simplifying fractions and ratio calculations. All operations return formatted strings alongside raw values for immediate display or further computation.

### Agent Description

Math calculations: percentages, ratios, rounding, random numbers, aggregates (sum, avg, min, max), GCD. Returns formatted and raw values.

## Details Tab

### Details

A utility for common mathematical calculations frequently needed in business, finance, data analysis, and everyday applications. It provides comprehensive percentage operations including calculating what percent one value is of another, finding a percentage of a given number, and determining percent increase or decrease between two values for tracking growth or decline metrics. Ratio calculation simplifies proportions between multiple numbers by finding the greatest common divisor and reducing to the smallest whole number representation. Number rounding supports configurable decimal precision from 0 to 10 places for formatting financial figures, measurements, and display values. Random number generation produces both floating-point values with specified decimal precision and integers within defined minimum and maximum bounds for sampling, testing, and simulation purposes. Aggregate functions operate on arrays of numbers to calculate sums, arithmetic averages, and identify minimum and maximum values with their array positions. The greatest common divisor function finds the largest integer that evenly divides all numbers in a set, useful for simplifying fractions and ratio calculations. All operations return formatted strings alongside raw values for immediate display or further computation.

### Actions

- `math-percent-calculate` (5 credits): Calculate what percentage one value is of a total. Provide two numbers: [value, total]. Returns the percentage with formatted output.
- `math-percentage-of` (5 credits): Calculate X% of a given value. For example, calculate 15% of 200. Returns the computed result.
- `math-percent-increase` (5 credits): Calculate the percent increase from an original value to a new value. Provide two numbers: [original, new].
- `math-percent-decrease` (5 credits): Calculate the percent decrease from an original value to a new value. Provide two numbers: [original, new].
- `math-ratio-calculate` (5 credits): Calculate and simplify the ratio between two or more numbers. Returns the simplified ratio.
- `math-round-number` (5 credits): Round a number to a specified number of decimal places.
- `math-random-number` (5 credits): Generate a random floating-point number within a specified range, rounded to a given number of decimal places.
- `math-random-integer` (5 credits): Generate a random integer within a specified range (inclusive on both ends).
- `math-sum` (5 credits): Calculate the sum of an array of numbers.
- `math-average` (5 credits): Calculate the arithmetic mean (average) of an array of numbers.
- `math-min` (5 credits): Find the minimum (smallest) value in an array of numbers.
- `math-max` (5 credits): Find the maximum (largest) value in an array of numbers.
- `math-gcd` (5 credits): Calculate the greatest common divisor (GCD) of an array of integers.

### Use Cases

Percentage calculation, percent of total, what percent is X of Y, percentage of value, calculate X percent of Y, percent increase calculation, growth rate calculation, percent decrease calculation, decline rate calculation, year over year change, price change percentage, ratio calculation, ratio simplification, proportion calculation, aspect ratio, recipe ratio scaling, number rounding, decimal place formatting, financial rounding, currency formatting, precision control, random number generation, random float generation, random decimal, random integer generation, random int range, dice roll simulation, lottery number generator, random sampling, sum calculation, total calculation, add numbers, array sum, average calculation, mean calculation, arithmetic mean, data average, minimum value finder, min function, lowest value, array minimum, maximum value finder, max function, highest value, array maximum, GCD calculation, greatest common divisor, fraction simplification, common factor, business math, financial calculations, data analysis math, statistical operations, AI agent math, LLM calculations, automation math operations, workflow calculations, quick math API

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Advanced Tab

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "694ecf2fcca5b5123ad00c32",
    "parameters": {
      "action": "math-percent-calculate",
      "numbers": []
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "math-percent-calculate": {
      "description": "Calculate what percentage one value is of a total. Provide two numbers: [value, total]. Returns the percentage with formatted output.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of exactly 2 numbers: [value, total]. Example: [25, 200] calculates what percent 25 is of 200.",
          "required": true
        }
      }
    },
    "math-percentage-of": {
      "description": "Calculate X% of a given value. For example, calculate 15% of 200. Returns the computed result.",
      "properties": {
        "percent": {
          "type": "number",
          "description": "The percentage to apply (e.g., 25 for 25%).",
          "required": true
        },
        "value": {
          "type": "number",
          "description": "The value to calculate the percentage of.",
          "required": true
        }
      }
    },
    "math-percent-increase": {
      "description": "Calculate the percent increase from an original value to a new value. Provide two numbers: [original, new].",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of exactly 2 numbers: [original, new]. Example: [100, 150] calculates percent increase from 100 to 150.",
          "required": true
        }
      }
    },
    "math-percent-decrease": {
      "description": "Calculate the percent decrease from an original value to a new value. Provide two numbers: [original, new].",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of exactly 2 numbers: [original, new]. Example: [200, 150] calculates percent decrease from 200 to 150.",
          "required": true
        }
      }
    },
    "math-ratio-calculate": {
      "description": "Calculate and simplify the ratio between two or more numbers. Returns the simplified ratio.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of 2 or more numbers to calculate the ratio for. Example: [10, 25, 50].",
          "required": true
        }
      }
    },
    "math-round-number": {
      "description": "Round a number to a specified number of decimal places.",
      "properties": {
        "value": {
          "type": "number",
          "description": "The number to round.",
          "required": true
        },
        "decimals": {
          "type": "integer",
          "description": "Number of decimal places (0-10). Default: 2.",
          "required": false,
          "default": 2,
          "minimum": 0,
          "maximum": 10
        }
      }
    },
    "math-random-number": {
      "description": "Generate a random floating-point number within a specified range, rounded to a given number of decimal places.",
      "properties": {
        "min_value": {
          "type": "number",
          "description": "Minimum value for the random number (inclusive).",
          "required": true
        },
        "max_value": {
          "type": "number",
          "description": "Maximum value for the random number (exclusive). Must be greater than min_value.",
          "required": true
        },
        "decimals": {
          "type": "integer",
          "description": "Number of decimal places for the result (0-10). Default: 2.",
          "required": false,
          "default": 2,
          "minimum": 0,
          "maximum": 10
        }
      }
    },
    "math-random-integer": {
      "description": "Generate a random integer within a specified range (inclusive on both ends).",
      "properties": {
        "min_value": {
          "type": "number",
          "description": "Minimum integer value (inclusive).",
          "required": true
        },
        "max_value": {
          "type": "number",
          "description": "Maximum integer value (inclusive). Must be greater than min_value.",
          "required": true
        }
      }
    },
    "math-sum": {
      "description": "Calculate the sum of an array of numbers.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of 1 or more numbers to sum. Example: [10, 20, 30].",
          "required": true
        }
      }
    },
    "math-average": {
      "description": "Calculate the arithmetic mean (average) of an array of numbers.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of 1 or more numbers to average. Example: [10, 20, 30].",
          "required": true
        }
      }
    },
    "math-min": {
      "description": "Find the minimum (smallest) value in an array of numbers.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of 1 or more numbers. Returns the smallest value and its index.",
          "required": true
        }
      }
    },
    "math-max": {
      "description": "Find the maximum (largest) value in an array of numbers.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of 1 or more numbers. Returns the largest value and its index.",
          "required": true
        }
      }
    },
    "math-gcd": {
      "description": "Calculate the greatest common divisor (GCD) of an array of integers.",
      "properties": {
        "numbers": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of 1 or more integers. Values are converted to integers before calculation.",
          "required": true
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "The mathematical operation to perform. Use 'get_instructions' to retrieve documentation. Available actions: Percentage operations (math-percent-calculate, math-percentage-of, math-percent-increase, math-percent-decrease), Number operations (math-ratio-calculate, math-round-number, math-sum, math-average, math-min, math-max, math-gcd), Random generation (math-random-number, math-random-integer)",
      "required": true,
      "enum": [
        "get_instructions",
        "math-percent-calculate",
        "math-percentage-of",
        "math-percent-increase",
        "math-percent-decrease",
        "math-ratio-calculate",
        "math-round-number",
        "math-random-number",
        "math-random-integer",
        "math-sum",
        "math-average",
        "math-min",
        "math-max",
        "math-gcd"
      ]
    },
    "numbers": {
      "type": "array",
      "description": "Array of numbers for multi-value operations. Used for: math-percent-calculate ([value, total]), math-percent-increase ([original, new]), math-percent-decrease ([original, new]), math-ratio-calculate (2+ numbers), math-sum (1+ numbers), math-average (1+ numbers), math-min (1+ numbers), math-max (1+ numbers), math-gcd (1+ integers)",
      "required": false,
      "items": {
        "type": "number"
      }
    },
    "value": {
      "type": "number",
      "description": "Single numeric value. Used for: math-percentage-of (the value to calculate percentage of), math-round-number (the number to round)",
      "required": false
    },
    "percent": {
      "type": "number",
      "description": "Percentage value (e.g., 25 for 25%). Used for: math-percentage-of (calculate X% of value)",
      "required": false
    },
    "decimals": {
      "type": "integer",
      "description": "Number of decimal places (0-10). Used for: math-round-number, math-random-number. Default: 2",
      "required": false,
      "default": 2,
      "minimum": 0,
      "maximum": 10
    },
    "min_value": {
      "type": "number",
      "description": "Minimum value for random generation. Used for: math-random-number, math-random-integer",
      "required": false
    },
    "max_value": {
      "type": "number",
      "description": "Maximum value for random generation. Used for: math-random-number, math-random-integer",
      "required": false
    }
  }
}
```

### Usage Instructions

# Complex Math Tool - Instructions

## Overview
The Complex Math Tool provides a comprehensive set of mathematical operations including percentage calculations, number rounding, random number generation, aggregate operations (sum, average, min, max), ratio simplification, and greatest common divisor computation.

## Actions

### math-percent-calculate
Calculate what percentage one value is of a total.

**Required fields:**
- `numbers` (array): Exactly 2 numbers — [value, total]

**Example:**
```json
{
  "action": "math-percent-calculate",
  "numbers": [25, 200]
}
```
Returns: "25 is 12.5% of 200"

---

### math-percentage-of
Calculate X% of a given value.

**Required fields:**
- `percent` (number): The percentage to apply (e.g., 25 for 25%)
- `value` (number): The base value

**Example:**
```json
{
  "action": "math-percentage-of",
  "percent": 15,
  "value": 200
}
```
Returns: "15% of 200 = 30"

---

### math-percent-increase
Calculate the percent increase from an original value to a new value.

**Required fields:**
- `numbers` (array): Exactly 2 numbers — [original, new]

**Example:**
```json
{
  "action": "math-percent-increase",
  "numbers": [100, 150]
}
```
Returns: "100 to 150 is a 50% increase"

---

### math-percent-decrease
Calculate the percent decrease from an original value to a new value.

**Required fields:**
- `numbers` (array): Exactly 2 numbers — [original, new]

**Example:**
```json
{
  "action": "math-percent-decrease",
  "numbers": [200, 150]
}
```
Returns: "200 to 150 is a 25% decrease"

---

### math-ratio-calculate
Simplify the ratio between two or more numbers.

**Required fields:**
- `numbers` (array): 2 or more numbers

**Example:**
```json
{
  "action": "math-ratio-calculate",
  "numbers": [10, 25, 50]
}
```
Returns: Simplified ratio "2:5:10"

---

### math-round-number
Round a number to a specified number of decimal places.

**Required fields:**
- `value` (number): The number to round

**Optional fields:**
- `decimals` (integer, 0-10): Decimal places. Default: 2

**Example:**
```json
{
  "action": "math-round-number",
  "value": 3.14159,
  "decimals": 3
}
```
Returns: 3.142

---

### math-random-number
Generate a random floating-point number within a range.

**Required fields:**
- `min_value` (number): Minimum value (inclusive)
- `max_value` (number): Maximum value (must be greater than min_value)

**Optional fields:**
- `decimals` (integer, 0-10): Decimal places for the result. Default: 2

**Example:**
```json
{
  "action": "math-random-number",
  "min_value": 1.0,
  "max_value": 100.0,
  "decimals": 4
}
```
Returns: A random float between 1.0 and 100.0 with 4 decimal places

---

### math-random-integer
Generate a random integer within a range (inclusive on both ends).

**Required fields:**
- `min_value` (number): Minimum integer value (inclusive)
- `max_value` (number): Maximum integer value (inclusive, must be greater than min_value)

**Example:**
```json
{
  "action": "math-random-integer",
  "min_value": 1,
  "max_value": 100
}
```
Returns: A random integer between 1 and 100

---

### math-sum
Calculate the sum of an array of numbers.

**Required fields:**
- `numbers` (array): 1 or more numbers

**Example:**
```json
{
  "action": "math-sum",
  "numbers": [10, 20, 30, 40, 50]
}
```
Returns: 150

---

### math-average
Calculate the arithmetic mean of an array of numbers.

**Required fields:**
- `numbers` (array): 1 or more numbers

**Example:**
```json
{
  "action": "math-average",
  "numbers": [85, 90, 78, 92, 88]
}
```
Returns: 86.6

---

### math-min
Find the minimum (smallest) value in an array of numbers.

**Required fields:**
- `numbers` (array): 1 or more numbers

**Example:**
```json
{
  "action": "math-min",
  "numbers": [45, 12, 67, 3, 89]
}
```
Returns: 3 (at index 3)

---

### math-max
Find the maximum (largest) value in an array of numbers.

**Required fields:**
- `numbers` (array): 1 or more numbers

**Example:**
```json
{
  "action": "math-max",
  "numbers": [45, 12, 67, 3, 89]
}
```
Returns: 89 (at index 4)

---

### math-gcd
Calculate the greatest common divisor (GCD) of an array of integers.

**Required fields:**
- `numbers` (array): 1 or more integers (decimal values are converted to integers)

**Example:**
```json
{
  "action": "math-gcd",
  "numbers": [48, 36, 24]
}
```
Returns: GCD is 12

---

## Common Workflows

### Price discount calculation
1. Use `math-percentage-of` to calculate the discount amount (e.g., 20% of $150)
2. Use `math-sum` with a negative discount to get the final price

### Comparing performance metrics
1. Use `math-percent-increase` or `math-percent-decrease` to compare two periods
2. Use `math-average` to find the mean across multiple data points

### Statistical summary of a dataset
1. Use `math-sum` for the total
2. Use `math-average` for the mean
3. Use `math-min` and `math-max` for the range

### Random selection
1. Use `math-random-integer` for picking random IDs or indices
2. Use `math-random-number` for generating random decimal values (e.g., test data)

## Important Notes
- Division by zero is handled gracefully with descriptive error messages (e.g., percent-calculate with total=0)
- The `numbers` array order matters for percentage and ratio operations — check each action's description for the expected order
- GCD values are converted to integers before calculation
- Random number generation requires min_value to be strictly less than max_value
- All results include a human-readable `formatted` or `calculation` string for easy display

### About The Developer

- Vendor name: Apoth3osis
- Website: apoth3osis.io

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.