Math-MCP

A Model Context Protocol (MCP) server that provides basic mathematical, statistical and trigonometric functions to Large Language Models (LLMs). This server enables LLMs to perform accurate numerical calculations through a simple API.

Features

Basic arithmetic operations (addition, subtraction, multiplication, division, sum, modulo)
Statistical functions (mean, median, mode, min, max)
Advanced statistics (variance, standard deviation, percentile, correlation, linear regression)
Rounding functions (floor, ceiling, round)
Trigonometric functions (sin, cos, tan, and their inverses; degrees/radians conversions)
Exact number theory and combinatorics (GCD, LCM, primes, factors, factorials, combinations, permutations)
Exact fraction simplification and arithmetic using arbitrary-size integers
Percentages, compound interest, and fixed-rate loan payments
Quadratic equations and 2x2 linear systems, including complex or non-unique solutions
3D graphics transforms, bone hierarchies, camera matrices, and world-to-screen projection
Bayes' theorem and normalized multi-hypothesis Bayesian updates

Installation

Note: Ensure you have Node.js installed on your computer.

Just clone this repository and save it locally somewhere on your computer.

Then add this server to your MCP configuration file:

"math": {
  "command": "node",
  "args": ["PATH\\TO\\PROJECT\\math-mcp\\build\\index.js"]
}

Here is an example for OpenCode

{
  "mcp": {
    "math-mcp": {
      "type": "local",
      "command": [
        "node",
        "PATH\\TO\\PROJECT\\math-mcp\\build\\index.js"
      ]
    }
  }
}

Replace PATH\\TO\\PROJECT with the actual path to where you cloned the repository.

Note: This project comes prebuilt, so installation is easy but if you change anything in the code, rebuild the project with npm run build.

Available Functions

The Math-MCP server provides the following mathematical operations:

Arithmetic Operations

Function	Description	Parameters
`add`	Adds two numbers together	`firstNumber`: The first addend`secondNumber`: The second addend
`subtract`	Subtracts the second number from the first number	`minuend`: The number to subtract from (minuend)`subtrahend`: The number being subtracted (subtrahend)
`multiply`	Multiplies two numbers together	`firstNumber`: The first number`secondNumber`: The second number
`division`	Divides the first number by the second number	`numerator`: The number being divided (numerator)`denominator`: The number to divide by (denominator)
`sum`	Adds any number of numbers together	`numbers`: Array of numbers to sum
`modulo`	Divides two numbers and returns the remainder	`numerator`: The number being divided (numerator)`denominator`: The number to divide by (denominator)
`floor`	Rounds a number down to the nearest integer	`number`: The number to round down
`ceiling`	Rounds a number up to the nearest integer	`number`: The number to round up
`round`	Rounds a number to the nearest integer	`number`: The number to round

Statistical Operations

Function	Description	Parameters
`mean`	Calculates the arithmetic mean of a list of numbers	`numbers`: Array of numbers to find the mean of
`median`	Calculates the median of a list of numbers	`numbers`: Array of numbers to find the median of
`mode`	Finds the most common number in a list of numbers	`numbers`: Array of numbers to find the mode of
`min`	Finds the minimum value from a list of numbers	`numbers`: Array of numbers to find the minimum of
`max`	Finds the maximum value from a list of numbers	`numbers`: Array of numbers to find the maximum of
`variance`	Calculates population or sample variance	`numbers`: Values`sample`: Optional; use `true` for n-1
`standard_deviation`	Calculates population or sample standard deviation	`numbers`: Values`sample`: Optional; use `true` for n-1
`percentile`	Calculates an inclusive R-7/Excel-style percentile	`numbers`: Values`percentile`: 0 through 100
`correlation`	Calculates Pearson correlation for paired observations	`firstValues`: First series`secondValues`: Second series
`linear_regression`	Fits `y = slope*x + intercept` and returns R-squared	`xValues`: X series`yValues`: Y series

Exact and Number-Theory Operations

Function	Description	Parameters
`greatest_common_divisor`	Finds the GCD of two safe integers	`first`, `second`: Integers
`least_common_multiple`	Finds the exact LCM as a decimal string	`first`, `second`: Integers
`is_prime`	Tests a safe integer for primality	`value`: Non-negative integer
`prime_factors`	Finds prime factors up to 1,000,000,000,000	`value`: Integer
`factorial`	Calculates n! exactly through 1000!	`value`: Integer
`combinations`	Calculates n choose r exactly	`total`: n`selected`: r
`permutations`	Calculates nPr exactly	`total`: n`selected`: r
`simplify_fraction`	Reduces an arbitrary-size integer fraction exactly	`numerator`, `denominator`: Decimal integer strings
`fraction_arithmetic`	Adds, subtracts, multiplies, or divides fractions exactly	`operation`; two numerator/denominator pairs as strings

Applied Operations

Function	Description	Parameters
`percentage_of`	Calculates a percentage of a value	`valuepercentage`: Use 15 for 15%
`percentage_change`	Calculates percent increase or decrease	`originalValuenewValue`
`round_to`	Rounds to a requested number of decimal places	`valuedecimalPlaces`: 0 through 15
`compound_interest`	Calculates compound growth and optional end-of-period contributions	`principal`, `annualRatePercent`, `years`, `compoundsPerYear`, optional `contributionPerPeriod`
`loan_payment`	Calculates fixed-rate payment, total paid, and total interest	`principal`, `annualRatePercent`, `years`, `paymentsPerYear`

Algebra Operations

Function	Description	Parameters
`solve_quadratic`	Solves `ax^2 + bx + c = 0`, including complex roots	`a`, `b`, `c`
`solve_linear_system_2x2`	Solves or classifies two linear equations	Coefficients `a1`, `b1`, `c1`, `a2`, `b2`, `c2`

3D Graphics and Bone Projection

All matrices are flat, row-major 4x4 arrays used with column vectors. Transform composition is projection * view * world * point. Quaternions use {x, y, z, w}; Euler inputs are radians. Defaults are right-handed coordinates, OpenGL-style NDC depth -1..1, and a top-left screen origin where Y points down.

Function	Description
`quaternion_from_euler`	Converts Euler radians and an explicit rotation order to a quaternion
`compose_transform_4x4`	Builds a `translation * rotation * scale` matrix
`multiply_matrices_4x4`	Multiplies two matrices as `first * second`
`transform_point_3d`	Applies a matrix to a 3D point with homogeneous `w=1`
`bone_local_to_world`	Combines one bone's local transform with its parent world matrix
`bone_hierarchy_to_world`	Resolves named parent/child local transforms into world-space bones
`look_at_view_matrix`	Creates a right- or left-handed world-to-view camera matrix
`perspective_projection_matrix`	Creates a projection matrix with selectable handedness and clip-depth range
`world_to_view`	Applies the view matrix to a world-space point
`view_to_clip`	Applies the projection matrix to produce a 4D clip-space point
`clip_to_ndc`	Performs perspective division: `(x/w, y/w, z/w)`
`ndc_to_screen`	Scales NDC to a requested pixel width and height
`world_to_screen`	Runs projection with a combined `projection * view` matrix and reports visibility
`project_bone_points`	Batch-projects named world-space bone positions to 2D screen coordinates

The explicit projection pipeline is:

world point -> view matrix -> view point
view point  -> projection matrix -> clip point (x, y, z, w)
clip point  -> divide by w -> NDC
NDC         -> resolution scaling -> screen pixels

Probability Operations

Function	Description	Parameters
`bayes_theorem`	Calculates `P(H	E) = P(E
`bayes_update_hypotheses`	Normalizes likelihood-weighted priors across hypotheses	Array of hypothesis labels, priors, and likelihoods

Trigonometric Operations

Function	Description	Parameters
`sin`	Calculates the sine of a number in radians	`number`: The number in radians to find the sine of
`arcsin`	Calculates the arcsine (in radians) of a number	`number`: The number to find the arcsine of
`cos`	Calculates the cosine of a number in radians	`number`: The number in radians to find the cosine of
`arccos`	Calculates the arccosine (in radians) of a number	`number`: The number to find the arccosine of
`tan`	Calculates the tangent of a number in radians	`number`: The number in radians to find the tangent of
`arctan`	Calculates the arctangent (in radians) of a number	`number`: The number to find the arctangent of
`radiansToDegrees`	Converts a radian value to its equivalent in degrees	`number`: The number in radians to convert to degrees
`degreesToRadians`	Converts a degree value to its equivalent in radians	`number`: The number in degrees to convert to radians

Math-MCP

Math-MCP

Features

Installation

Available Functions

Arithmetic Operations

Statistical Operations

Exact and Number-Theory Operations

Applied Operations

Algebra Operations

3D Graphics and Bone Projection

Probability Operations

Trigonometric Operations

Latest Blog Posts

MCP directory API