Skip to main content
Glama
math-mcp
by AbderY

math-mcp

CI PyPI M8ven Score

A small Model Context Protocol (MCP) server that gives an LLM a set of reliable math tools — expression evaluation, statistics, number theory, linear algebra, and symbolic math — instead of asking it to do arithmetic in its head.

Every tool runs real, deterministic code. The expression evaluator is sandboxed: it parses input into an AST and only allows a whitelist of operators, constants, and functions. It never calls Python's eval. Symbolic tools parse input with SymPy's tokenizing parser (also no eval).

Tools

Numeric & number theory

Tool

Description

evaluate

Evaluate an expression like sqrt(2) * sin(pi / 4). Supports + - * / // % **, parentheses, constants (pi, e, tau) and functions (sqrt, sin, log, factorial, gcd, hypot, …).

descriptive_statistics

Count, sum, min, max, mean, median, variance and standard deviation (population and sample) of a list of numbers.

is_prime

Test whether an integer is prime.

prime_factorization

Factor a positive integer into primes with exponents.

gcd_lcm

Greatest common divisor and least common multiple of two or more integers.

solve_quadratic

Roots of a·x² + b·x + c = 0, real or complex, with the discriminant.

convert_base

Convert an integer between bases 2–36.

Linear algebra

Matrices are lists of rows, e.g. [[1, 2], [3, 4]].

Tool

Description

matrix_multiply

Matrix product A @ B.

matrix_transpose

Transpose of a matrix.

matrix_determinant

Determinant of a square matrix.

matrix_inverse

Inverse of a square, non-singular matrix.

solve_linear_system

Solve A x = b for x.

Symbolic (SymPy)

Tool

Description

simplify_expression

Simplify, e.g. sin(x)**2 + cos(x)**2 → 1.

expand_expression

Expand, e.g. (x + 1)**2 → x**2 + 2*x + 1.

factor_expression

Factor, e.g. x**2 - 1 → (x - 1)*(x + 1).

differentiate

Derivative w.r.t. a variable (any order).

integrate

Indefinite integral w.r.t. a variable.

definite_integral

Definite integral over [lower, upper] (bounds may be oo).

limit

Limit as a variable approaches a point (oo allowed; left/right/two-sided).

taylor_series

Taylor series about a point, up to N terms.

solve_symbolic_equation

Solve an equation, e.g. x**2 = 4 → ["-2", "2"].

Related MCP server: precision-math-mcp

Resources & prompts

Beyond tools, the server exposes:

  • Resources — mathematical constants to 50 digits: math://constants (an index) and math://constants/{name} for pi, e, tau, phi (golden ratio) and gamma (Euler–Mascheroni).

  • Prompts — reusable templates a client can offer to the user: solve_step_by_step and solve_linear_system_prompt.

Install

Requires Python 3.10+.

Once published to PyPI (distribution name math-mcp-ay):

pip install math-mcp-ay

The import package is math_mcp and the command is math-mcp regardless of the distribution name.

From source (for development):

git clone https://github.com/AbderY/math-mcp.git
cd math-mcp
pip install -e ".[dev]"

Run

The server speaks MCP over stdio:

math-mcp
# or
python -m math_mcp

Use with an MCP client

Add it to your client's MCP configuration. For example (Claude Desktop / claude_desktop_config.json, or any MCP client that launches servers):

{
  "mcpServers": {
    "math": {
      "command": "math-mcp"
    }
  }
}

If math-mcp is not on your PATH, use the interpreter form instead:

{
  "mcpServers": {
    "math": {
      "command": "python",
      "args": ["-m", "math_mcp"]
    }
  }
}

Examples

  • evaluate("2 ** 10 + factorial(5)") → 1144.0

  • descriptive_statistics([2, 4, 4, 4, 5, 5, 7, 9]) → mean 5.0, pstdev 2.0

  • prime_factorization(360) → 2³ · 3² · 5

  • solve_quadratic(1, -3, 2) → roots 1.0 and 2.0

  • convert_base("ff", 16, 2) → "11111111"

  • matrix_inverse([[4, 7], [2, 6]]) → [[0.6, -0.7], [-0.2, 0.4]]

  • solve_linear_system([[1, 1], [1, -1]], [3, 1]) → [2.0, 1.0]

  • differentiate("x**3", "x", 2) → "6*x"

  • definite_integral("exp(-x)", "x", "0", "oo") → "1"

  • limit("sin(x)/x", "x", "0") → "1"

  • taylor_series("exp(x)", "x", "0", 4) → "x**3/6 + x**2/2 + x + 1"

  • solve_symbolic_equation("x**2 = 4") → ["-2", "2"]

Development

pip install -e ".[dev]"
pytest

Releasing to PyPI

Publishing is automated via GitHub Actions using PyPI Trusted Publishing (OIDC), so no API token is stored in the repo.

One-time setup on pypi.org:

  1. Create (or claim) the project name math-mcp-ay.

  2. Under the project's Publishing settings, add a trusted publisher:

    • Owner: AbderY, repository: math-mcp

    • Workflow: publish.yml

    • Environment: pypi

Then, to release: bump the version in pyproject.toml and src/math_mcp/__init__.py, tag it, and publish a GitHub Release. The publish.yml workflow builds the sdist + wheel and uploads them to PyPI.

License

MIT

Available Tools

21 tools
convert_baseA

Convert an integer number from one base to another.

number is given as a string in from_base (2-36); the result is a string in to_base (2-36). Example: ("ff", 16, 2) -> "11111111".

Inputs: number (required), to_base (required), from_base (required). Returns: result

definite_integralB

Definite integral of expression from lower to upper.

Bounds are expressions, so oo / -oo / pi are accepted.

Inputs: expression (required), lower, upper, variable. Returns: result

descriptive_statisticsA

Return summary statistics for a list of numbers.

Includes count, sum, min, max, mean, median, population and sample standard deviation, and variance. Requires at least one value (sample stdev/variance require at least two and are null otherwise).

Inputs: numbers (required). Returns: object

differentiateB

Differentiate expression w.r.t. variable (optionally to a higher order).

Inputs: expression (required), order, variable. Returns: result

evaluateA

Evaluate a mathematical expression and return its numeric value.

Supports + - * / // % **, parentheses, the constants pi, e, tau and functions such as sqrt, sin, cos, log, exp, factorial, gcd, hypot. Evaluation is sandboxed: no Python eval is used and only whitelisted names are allowed.

Example: "sqrt(2) * sin(pi / 4)" -> 1.0.

Inputs: expression (required). Returns: result

expand_expressionA

Expand a symbolic expression, e.g. (x + 1)**2 -> x**2 + 2*x + 1.

Inputs: expression (required). Returns: result

factor_expressionA

Factor a symbolic expression, e.g. x**2 - 1 -> (x - 1)*(x + 1).

Inputs: expression (required). Returns: result

gcd_lcmA

Return the greatest common divisor and least common multiple.

Accepts two or more integers, e.g. [12, 18, 24].

Inputs: numbers (required). Returns: object

integrateB

Return the indefinite integral of expression w.r.t. variable.

Inputs: expression (required), variable. Returns: result

is_primeA

Return whether the integer n is a prime number.

Uses trial division up to sqrt(n). Values below 2 are not prime.

Inputs: n (required). Returns: result

limitA

Limit of expression as variable -> point (oo allowed).

direction: "+" (right), "-" (left) or "+-" (two-sided).

Inputs: expression (required), point, variable, direction. Returns: result

matrix_determinantB

Return the determinant of a square matrix.

Inputs: matrix (required). Returns: result

matrix_inverseB

Return the inverse of a square, non-singular matrix.

Inputs: matrix (required). Returns: result

matrix_multiplyA

Return the matrix product A @ B.

Columns of A must match rows of B. Matrices are lists of rows.

Inputs: a (required), b (required). Returns: result

matrix_transposeB

Return the transpose of a matrix.

Inputs: matrix (required). Returns: result

prime_factorizationA

Return the prime factorization of a positive integer n.

The result is a list of {"prime": p, "exponent": k} entries, ordered by prime. prime_factorization(360) -> 2^3 * 3^2 * 5^1.

Inputs: n (required). Returns: result

simplify_expressionB

Simplify a symbolic expression, e.g. sin(x)**2 + cos(x)**2 -> 1.

Inputs: expression (required). Returns: result

solve_linear_systemA

Solve A x = b for x, where A is square and non-singular.

Inputs: a (required), b (required). Returns: result

solve_quadraticA

Solve a*x^2 + b*x + c = 0 and return its roots.

Reports the discriminant and the (real or complex) roots. Requires a != 0; use a linear solve otherwise.

Inputs: a (required), b (required), c (required). Returns: object

solve_symbolic_equationB

Solve an equation for a variable, e.g. "x**2 = 4" -> ["-2", "2"].

Accepts a bare expression (assumed = 0) or an explicit = equation.

Inputs: equation (required), variable. Returns: result

taylor_seriesB

Taylor series of expression about point up to order terms (O-term dropped).

Inputs: expression (required), order, point, variable. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools target clearly distinct mathematical operations, but a few boundaries overlap: solve_quadratic is a special case of solve_symbolic_equation, matrix_inverse is closely related to solve_linear_system, and evaluate vs simplify_expression could be confused by less careful agents. Descriptions generally clarify the intended use, so misselection is unlikely but possible.

    Naming Consistency4/5

    All names use snake_case and are domain-readable, which is a strong baseline. However, the set mixes verb phrases (evaluate, differentiate, integrate), noun phrases (taylor_series, descriptive_statistics, definite_integral), and bare operation names (limit), so the pattern is not fully predictable.

    Tool Count4/5

    21 tools is above the ideal 3-15 range, but the math domain is broad and each tool covers a distinct operation across calculus, algebra, matrices, number theory, and statistics. The count is slightly heavy yet still reasonable for a comprehensive math toolkit.

    Completeness4/5

    The surface covers core algebra, calculus, linear algebra, number theory, statistics, and base conversion with no obvious dead ends. Minor gaps remain, such as matrix addition/eigenvalues, general polynomial manipulation beyond quadratic solving, complex arithmetic, and numerical root-finding.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to perform accurate mathematical calculations by evaluating expressions using mathjs. Supports basic arithmetic, functions, constants, and complex mathematical operations through natural language requests.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides LLMs with accurate mathematical computation through a real calculator powered by math.js, offering tools for arithmetic, algebra, calculus, unit conversion, and more.
      232 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides over 500 deterministic tools for math, conversions, validation, hashing, and more, enabling AI agents to perform accurate calculations and data transformations without hallucination.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables safe math expression evaluation, unit conversion, statistical analysis, number formatting, and percentage calculations for AI agents via MCP.
      5
      49 npm
      MIT