| name | complex-math-tool |
| description | Complex Math Tool: Math calculations: percentages, ratios, rounding, random numbers, aggregates (sum, avg, min, max), GCD. Returns formatted and raw values. Use when an agent needs complex math tool, percentage calculation, percent of total, what percent is x of y, percentage of value, math average, numbers, math gcd through AgentPMT-hosted remote tool calls. Discovery terms: complex math tool, percentage calculation, percent of total, what percent is x of y, percentage of value, math average. |
| version | 1.0.0 |
| homepage | https://www.agentpmt.com/marketplace/complex-math-tool |
| compatibility | Agent instructions for AgentPMT-hosted remote tool calls. Follow this skill body for supported account, wallet, and setup routes. No local command runtime is declared. |
| metadata | {"author":"agentpmt","openclaw":{"homepage":"https://www.agentpmt.com/marketplace/complex-math-tool"}} |
Complex Math Tool
Freshness
Last updated: 2026-06-23.
If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.
What This Tool Does
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.
Product 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:
{
"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
When To Use
- Use this skill for
Complex Math Tool on AgentPMT.
- Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
- Search and activation keywords: complex math tool, percentage calculation, percent of total, what percent is x of y, percentage of value, math average, numbers, math gcd.
- Supported action names:
math-average, math-gcd, math-max, math-min, math-percent-calculate, math-percent-decrease, math-percent-increase, math-percentage-of, math-random-integer, math-random-number, math-ratio-calculate, math-round-number, math-sum.
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
Categories And Industries
No categories or industry tags are published for this tool.
Actions And Schema
Complete generated action schema: ./schema.md.
Supported action count: 13.
x402 availability: not enabled for this product.
math-average (action slug: math-average): Calculate the arithmetic mean (average) of an array of numbers. Price: 5 credits. Parameters: numbers.math-gcd (action slug: math-gcd): Calculate the greatest common divisor (GCD) of an array of integers. Price: 5 credits. Parameters: numbers.math-max (action slug: math-max): Find the maximum (largest) value in an array of numbers. Price: 5 credits. Parameters: numbers.math-min (action slug: math-min): Find the minimum (smallest) value in an array of numbers. Price: 5 credits. Parameters: numbers.math-percent-calculate (action slug: math-percent-calculate): Calculate what percentage one value is of a total. Provide two numbers: [value, total]. Returns the percentage with formatted output. Price: 5 credits. Parameters: numbers.math-percent-decrease (action slug: math-percent-decrease): Calculate the percent decrease from an original value to a new value. Provide two numbers: [original, new]. Price: 5 credits. Parameters: numbers.math-percent-increase (action slug: math-percent-increase): Calculate the percent increase from an original value to a new value. Provide two numbers: [original, new]. Price: 5 credits. Parameters: numbers.math-percentage-of (action slug: math-percentage-of): Calculate X% of a given value. For example, calculate 15% of 200. Returns the computed result. Price: 5 credits. Parameters: percent, value.math-random-integer (action slug: math-random-integer): Generate a random integer within a specified range (inclusive on both ends). Price: 5 credits. Parameters: max_value, min_value.math-random-number (action slug: math-random-number): Generate a random floating-point number within a specified range, rounded to a given number of decimal places. Price: credits. Parameters: , , .
Live Schema And Examples
Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.
- Exact schema: call
agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "complex-math-tool".
- Detailed examples: call
agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "complex-math-tool", or call this product with action: "get_instructions" when the product tool is already selected.
- Treat returned live schema and instructions as more specific than this generated summary.
MCP schema lookup through the main AgentPMT MCP server:
{
"method": "tools/call",
"params": {
"name": "AgentPMT-Tool-Search-and-Execution",
"arguments": {
"action": "get_schema",
"tool_id": "complex-math-tool"
}
}
}
For live examples, keep the same MCP tool and use these arguments:
{
"action": "get_instructions",
"tool_id": "complex-math-tool"
}
Authenticated AgentPMT REST schema lookup body:
{
"name": "agentpmt-tool-search-and-execution",
"parameters": {
"action": "get_schema",
"tool_id": "complex-math-tool"
}
}
Authenticated AgentPMT REST live examples body:
{
"name": "agentpmt-tool-search-and-execution",
"parameters": {
"action": "get_instructions",
"tool_id": "complex-math-tool"
}
}
Call This Tool
Product slug: complex-math-tool
Marketplace page: https://www.agentpmt.com/marketplace/complex-math-tool
- AgentPMT account route: first use
../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
- x402 route: not enabled for this product.
- AgentPMT overview: use
../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.
If those setup skills are not installed beside this product skill, use the downloads below.
Core AgentPMT setup skills:
- What AgentPMT is: ../what-is-agentpmt
- AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
skills.sh install script:
npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup
MCP call shape after the main AgentPMT MCP server is connected:
{
"method": "tools/call",
"params": {
"name": "Complex-Math-Tool",
"arguments": {
"action": "math-average",
"numbers": [
1
]
}
}
}
Use the exact tool name returned by tools/list; the name above is the expected readable form.
Authenticated AgentPMT REST call body:
{
"name": "complex-math-tool",
"parameters": {
"action": "math-average",
"numbers": [
1
]
}
}
Use the setup skill for the account connection details before making REST calls.
Response Handling
- Treat the returned JSON as the source of truth for this tool call.
- If the response includes warnings or correction targets, apply them before retrying.
- If the response includes a
passed or success-style boolean, use it as the workflow gate.
- If validation fails or the response shape is unclear, call
get_schema or get_instructions before retrying.
- If
math-average fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.
Security
- Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
- Keep tool inputs scoped to the minimum content needed for the task.
- Use the setup skills for credential handling; this product skill only defines product-specific behavior.
AgentPMT Reference
