BrainyCalc Overview
BrainyCalc is a Model Context Protocol (MCP) math server that gives LLMs and AI agents accurate, independently verified, and reproducible mathematical results — with full auditability. Instead of letting an LLM estimate mathematical answers, the AI delegates computation to BrainyCalc's deterministic engine.
At a glance
Quick Start
Add BrainyCalc to any MCP-compatible agent in one step. Add the following block to your MCP configuration file:
{ "mcpServers": { "brainycalc": { "command": "npx", "args": ["-y", "brainycalc"] } } }
BrainyCalc requires Node.js ≥ 18 and npm ≥ 7. The npx -y flag automatically downloads the latest version on first run — no separate install step needed.
How it works
When your AI agent encounters a computation, it sends a tool call to BrainyCalc over standard MCP JSON-RPC stdio. BrainyCalc processes it through a 6-step pipeline and returns a verified, auditable result.
Compute
Uses reliable numerical or symbolic methods. Never estimates.
Verify
An independent second pass catches instabilities before results reach your agent.
Reproduce
Same input always produces the same output — non-determinism is eliminated.
Report confidence
Every result includes a confidence score and error bound.
Record provenance
Engine version, method, and parameters captured with every result.
Audit trail
Fingerprinted and stored — inspect or reproduce any result at any time.
Tool categories
BrainyCalc exposes 100+ tools across four categories. Click any category to explore its full API reference.
Mathematics
Arithmetic, algebra, calculus, statistics, geometry, trigonometry, and more — all deterministic.
Unit Conversions
80+ converters across length, mass, energy, electrical, thermodynamics, data, and specialist domains.
Fitness & Health
BMI, BMR, TDEE, body fat, ideal weight, macronutrients, heart rate zones — verified science.
Date & Time
Date differences, age calculation, working days, time zones, pregnancy, and cycle tracking.
Requirements
| Dependency | Minimum Version | Notes |
|---|---|---|
node |
18 | ESM module support required |
npm |
7 | For npx invocation |
Compatible platforms
BrainyCalc speaks standard MCP over JSON-RPC stdio and works with any MCP-compatible platform:
| Platform | Notes |
|---|---|
| Claude Desktop (Anthropic) | Add to claude_desktop_config.json |
| LangChain agents | Use the MCP adapter for LangChain |
| Custom SDK implementations | Standard JSON-RPC stdio transport |
| Self-hosted / cluster deployments | Locally runnable for lower latency |
Tool schemas are automatically exposed via the MCP tools/list endpoint — no manual wiring required. Your agent discovers all 100+ tools on first connection.