$Complex Math Tool icon$

Complex Math Tool

Available ActionsEach successful request consumes credits as outlined below.

math-percent-calculate^5crmath-percentage-of^5crmath-percent-increase^5crmath-percent-decrease^5crmath-ratio-calculate^5crmath-round-number^5crmath-random-number^5crmath-random-integer^5crmath-sum^5crmath-average^5crmath-min^5crmath-max^5crmath-gcd^5cr

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.

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

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.

npm install -g @agentpmt/mcp-routeragentpmt-setup

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

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "694ecf2fcca5b5123ad00c32",
    "parameters": {
        "action": "math-percent-calculate",
        "numbers": []
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "694ecf2fcca5b5123ad00c32",
  parameters: {
    "action": "math-percent-calculate",
    "numbers": []
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "694ecf2fcca5b5123ad00c32",
  parameters: {
    "action": "math-percent-calculate",
    "numbers": []
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:694ecf2fcca5b5123ad00c32
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/694ecf2fcca5b5123ad00c32/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Actions(13)

math-percent-calculate^5cr1 param(1 required)

Calculate what percentage one value is of a total. Provide two numbers: [value, total]. Returns the percentage with formatted output.

numbersrequiredarray

Array of exactly 2 numbers: [value, total]. Example: [25, 200] calculates what percent 25 is of 200.

Array of: number

math-percentage-of^5cr2 params(2 required)

Calculate X% of a given value. For example, calculate 15% of 200. Returns the computed result.

percentrequirednumber

The percentage to apply (e.g., 25 for 25%).

valuerequirednumber

The value to calculate the percentage of.

math-percent-increase^5cr1 param(1 required)

Calculate the percent increase from an original value to a new value. Provide two numbers: [original, new].

numbersrequiredarray

Array of exactly 2 numbers: [original, new]. Example: [100, 150] calculates percent increase from 100 to 150.

Array of: number

math-percent-decrease^5cr1 param(1 required)

Calculate the percent decrease from an original value to a new value. Provide two numbers: [original, new].

numbersrequiredarray

Array of exactly 2 numbers: [original, new]. Example: [200, 150] calculates percent decrease from 200 to 150.

Array of: number

math-ratio-calculate^5cr1 param(1 required)

Calculate and simplify the ratio between two or more numbers. Returns the simplified ratio.

numbersrequiredarray

Array of 2 or more numbers to calculate the ratio for. Example: [10, 25, 50].

Array of: number

math-round-number^5cr2 params(1 required)

Round a number to a specified number of decimal places.

valuerequirednumber

The number to round.

decimalsinteger

Number of decimal places (0-10). Default: 2.

Default: 2

Range: 0 - 10

math-random-number^5cr3 params(2 required)

Generate a random floating-point number within a specified range, rounded to a given number of decimal places.

min_valuerequirednumber

Minimum value for the random number (inclusive).

max_valuerequirednumber

Maximum value for the random number (exclusive). Must be greater than min_value.

decimalsinteger

Number of decimal places for the result (0-10). Default: 2.

Default: 2

Range: 0 - 10

math-random-integer^5cr2 params(2 required)

Generate a random integer within a specified range (inclusive on both ends).

min_valuerequirednumber

Minimum integer value (inclusive).

max_valuerequirednumber

Maximum integer value (inclusive). Must be greater than min_value.

math-sum^5cr1 param(1 required)

Calculate the sum of an array of numbers.

numbersrequiredarray

Array of 1 or more numbers to sum. Example: [10, 20, 30].

Array of: number

math-average^5cr1 param(1 required)

Calculate the arithmetic mean (average) of an array of numbers.

numbersrequiredarray

Array of 1 or more numbers to average. Example: [10, 20, 30].

Array of: number

math-min^5cr1 param(1 required)

Find the minimum (smallest) value in an array of numbers.

numbersrequiredarray

Array of 1 or more numbers. Returns the smallest value and its index.

Array of: number

math-max^5cr1 param(1 required)

Find the maximum (largest) value in an array of numbers.

numbersrequiredarray

Array of 1 or more numbers. Returns the largest value and its index.

Array of: number

math-gcd^5cr1 param(1 required)

Calculate the greatest common divisor (GCD) of an array of integers.

numbersrequiredarray

Array of 1 or more integers. Values are converted to integers before calculation.

Array of: number

Usage Instructions

Usage guidance provided directly by the developer for this product.

Complex Math Tool - Instructions

Name: Complex Math Tool
Brand: Apoth3osis
SKU: 694ecf2fcca5b5123ad00c32
Price: 0.05 USD
Availability: InStock

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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "action": "math-gcd",
  "numbers": [48, 36, 24]
}

Returns: GCD is 12

Common Workflows

Price discount calculation

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

Comparing performance metrics

Use math-percent-increase or math-percent-decrease to compare two periods
Use math-average to find the mean across multiple data points

Statistical summary of a dataset

Use math-sum for the total
Use math-average for the mean
Use math-min and math-max for the range

Random selection

Use math-random-integer for picking random IDs or indices
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

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

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.

Complex Math Tool

Description