Precisioncalc MCP

High-precision finance & business calculations for AI agents — exact decimals, never floats.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "precisioncalc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "precisioncalc-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

PrecisionCalc MCP

A deterministic Model Context Protocol (MCP) server that gives LLM agents reliable, high-precision business, finance, and operational calculations.

LLMs routinely lose precision or hallucinate on multi-step financial formulas, currency conversions, business-day logic, and growth math. PrecisionCalc offloads that work to exact, transparent tools. Every monetary/financial value is computed with Python's decimal module (never floats), and every result is returned in a consistent, agent-parseable JSON envelope that includes the exact value, a human-readable value, the formula applied, the inputs used, the unit, and any assumptions/warnings.

v2 highlights: live + historical FX (ECB), 14 SaaS metrics, NPV/IRR, loan amortization, depreciation, a batch_calculate tool, per-country holidays, API-key auth + rate limiting + usage metering on the HTTP transport, structured JSON logging, optional OpenTelemetry tracing, and property-based tests.

🌐 Live hosted server (free, no install)

A public remote MCP server runs on Cloudflare's edge — point any Streamable-HTTP MCP client at it:

Code

https://precisioncalc-mcp.pages.dev/mcp

Install via npm (stdio, no hosting)

Run the server locally over stdio with a single command — nothing to deploy:

Terminal

npx -y precisioncalc-mcp

Claude Desktop / any stdio MCP client (claude_desktop_config.json):

config.json

{ "mcpServers": { "precisioncalc": { "command": "npx", "args": ["-y", "precisioncalc-mcp"] } } }

This is the same deterministic engine as the hosted server, running on your machine.

config.json

{ "mcpServers": { "precisioncalc": {
    "type": "http", "url": "https://precisioncalc-mcp.pages.dev/mcp" } } }

The edge build (worker-src/) is a Cloudflare Pages Function that mirrors the Python engine using decimal.js — verified 17/17 exact output parity. Landing page + docs: https://precisioncalc-mcp.pages.dev.

Plans (hosted endpoint)

Plan	Price	Daily calls	Live/historical FX	`batch_calculate`
Free (no key)	$0	15 / day (per IP)	❌ static only	❌
Starter	$12/mo	5,000 / day	✅	✅
Pro	$39/mo	50,000 / day	✅	✅

Checkout is Stripe (subscription). On success you get an API key instantly; send it as X-API-Key: <key> (or Authorization: Bearer <key>). Manage/cancel at /portal. When a limit is hit, tools return a structured status:"error" envelope with type, usage, and an upgrade block containing checkout URLs — so an agent can surface the paywall to the user and act on it. Self-host (below) for unlimited calls with your own keys.

Billing internals live in worker-src/billing.mjs (Stripe REST + Cloudflare KV for keys and daily counters). Server env: STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, PRICE_STARTER, PRICE_PRO, FREE_DAILY, STARTER_DAILY, PRO_DAILY, and a PRECISIONCALC_KV namespace binding (see wrangler.toml).

Rebuild/redeploy the edge server:

Terminal

npm install          # decimal.js + esbuild
npm run deploy       # bundles worker-src -> site/_worker.js and deploys to Pages

What it does

11 tools, all returning a uniform structured response:

Tool	Purpose
`calculate_metric`	14 SaaS/business metrics (LTV, CAC, churn, MRR growth, NRR, GRR, Rule of 40, magic number, break-even, ...)
`currency_convert`	Convert 9 major currencies; static (offline) or live/historical ECB rates
`business_days`	Add/count business days, next/previous; US/UK/EU + any ISO country + custom holidays
`compound_growth`	Future value, present value, CAGR; 7 compounding frequencies incl. continuous
`net_present_value`	NPV / discounted cash flow of a cashflow series
`internal_rate_of_return`	IRR (Newton + bisection fallback)
`loan_amortization`	Level-payment loan: payment, totals, full schedule, extra-payment payoff
`depreciation`	straight-line / declining-balance / sum-of-years-digits schedules
`batch_calculate`	Run many calculations in one request
`list_metrics`	Discovery: every metric with descriptions + required params
`health_check`	Server status, version, capabilities

Consistent response envelope

Success:

config.json

{
  "status": "success",
  "value": "1600",                       // exact, full-precision (string for money/rates)
  "formatted_value": "$1,600.00",        // human-readable
  "formula": "LTV = (ARPU * gross_margin) / churn_rate",
  "inputs_used": { "arpu": "100", "gross_margin": "0.8", "churn_rate": "0.05" },
  "unit": "USD",
  "notes": ["LTV = (ARPU x gross_margin) / churn_rate.", "..."]
}

Error (never raised across the tool boundary):

config.json

{
  "status": "error",
  "error": {
    "type": "missing_parameter",
    "message": "Missing required parameter 'churn_rate'.",
    "hint": "Include 'churn_rate' in params. See list_metrics for the full schema."
  }
}

Project structure

Code

precisioncalc-mcp/
├── server.py                 # MCP server: tool definitions + transports
├── security.py               # API-key auth + token-bucket rate limit + metering (ASGI)
├── observability.py          # Structured JSON logging + optional OpenTelemetry
├── requirements.txt / pyproject.toml
├── Dockerfile / .dockerignore
├── fly.toml / render.yaml    # One-click hosting configs
├── .env.example
├── calculations/
│   ├── _util.py              # Decimal coercion, validation, formatting
│   ├── metrics.py            # 14 business/SaaS metrics + catalog
│   ├── currency.py           # FX: static + Frankfurter (live/historical) providers
│   ├── business_days.py      # Region-aware holidays (built-in + `holidays` lib)
│   ├── growth.py             # FV / PV / CAGR
│   └── finance.py            # NPV / IRR / loan amortization / depreciation
├── schemas/responses.py      # Response envelope helpers
├── examples/agent_example.py # End-to-end MCP client demo
├── site/                     # Static landing/docs page (Cloudflare Pages)
└── tests/                    # 49 unit tests + Hypothesis property tests

Requirements

Python 3.11+ (developed/tested on 3.12)
Core: mcp, python-dateutil
Recommended: uvicorn + starlette (HTTP transport), holidays (per-country calendars)
Optional: opentelemetry-sdk (tracing), pytest + hypothesis (tests)

The server auto-detects the SDK layout and works with mcp >= 2.0 (MCPServer), mcp 1.x (FastMCP), or the standalone fastmcp package.

Run it locally

bash

cd precisioncalc-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt          # or: pip install -e ".[all]"

# stdio transport (default; how MCP clients launch it)
python server.py            # or: precisioncalc-mcp   (console entrypoint)

# Streamable HTTP transport (endpoint: /mcp)
python server.py http
PRECISIONCALC_API_KEYS=key1,key2 PRECISIONCALC_FX_PROVIDER=frankfurter python server.py http

Demo + tests:

bash

python examples/agent_example.py         # live end-to-end over stdio
python tests/test_calculations.py        # 28 core tests (no pytest needed)
python tests/test_v2.py                  # 17 v2 tests
python tests/test_properties.py          # Hypothesis property tests
# or simply:  pytest -q

Register with an MCP client (stdio)

config.json

{ "mcpServers": { "precisioncalc": {
    "command": "python", "args": ["/absolute/path/to/precisioncalc-mcp/server.py"] } } }

Deploy

Docker

Terminal

docker build -t precisioncalc-mcp .
docker run --rm -p 8000:8000 -e PRECISIONCALC_API_KEYS=your-key precisioncalc-mcp
docker run --rm -i precisioncalc-mcp python server.py stdio

Fly.io

Terminal

fly launch --no-deploy
fly secrets set PRECISIONCALC_API_KEYS=key1,key2
fly deploy

Render.com

Push to GitHub, then New + → Blueprint and point at the repo (render.yaml). Set PRECISIONCALC_API_KEYS as a secret in the dashboard.

Configuration (env vars)

Var	Default	Purpose
`PRECISIONCALC_HOST` / `PRECISIONCALC_PORT`	`127.0.0.1` / `8000`	HTTP bind
`PRECISIONCALC_API_KEYS`	(empty)	Comma-separated keys. Empty = open mode (still metered/limited by IP)
`PRECISIONCALC_RATE_LIMIT_PER_MIN` / `_BURST`	`120` / `40`	Token-bucket limits
`PRECISIONCALC_METRICS_PATH`	`/metrics`	Usage-metrics endpoint
`PRECISIONCALC_FX_PROVIDER`	`static`	`static` or `frankfurter` (live/historical ECB)
`PRECISIONCALC_FX_TTL` / `_TIMEOUT`	`3600` / `4`	FX cache TTL / HTTP timeout (s)
`PRECISIONCALC_LOG_LEVEL` / `_LOG_JSON`	`INFO` / `1`	Logging
`PRECISIONCALC_OTEL`	`0`	`1` enables OpenTelemetry tracing if SDK present

Tools & parameters

`calculate_metric(metric, params, currency="USD")`

Rates/margins are decimals (0.05 = 5%).

metric	params	unit
`ltv`	`arpu`, `churn_rate`, `gross_margin`(=1)	currency
`cac`	`total_spend`, `new_customers`	currency
`ltv_cac_ratio`	`ltv`, `cac`	ratio
`payback_period_months`	`cac`, `monthly_revenue_per_customer`, `gross_margin`(=1)	months
`contribution_margin`	`revenue`, `variable_costs`	currency
`gross_margin`	`revenue`, `cogs`	percent
`churn_rate`	`customers_lost`, `customers_at_start`	percent
`mrr_growth_rate`	`beginning_mrr`, `ending_mrr`	percent
`arr`	`mrr`	currency
`break_even_units`	`fixed_costs`, `price_per_unit`, `variable_cost_per_unit`	units
`nrr`	`starting_mrr`, `expansion_mrr`, `contraction_mrr`, `churned_mrr`	percent
`grr`	`starting_mrr`, `contraction_mrr`, `churned_mrr`	percent
`rule_of_40`	`growth_rate`, `profit_margin`	percent
`magic_number`	`current_quarter_revenue`, `prior_quarter_revenue`, `prior_quarter_sm_spend`	ratio

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Precisioncalc MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "precisioncalc-mcp": { "command": "npx", "args": ["-y", "precisioncalc-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Precisioncalc MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/precisioncalc-mcp?style=directory)](https://allmcps.com/mcp/precisioncalc-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/precisioncalc-mcp"><img src="https://allmcps.com/api/badge/precisioncalc-mcp?style=directory" alt="Precisioncalc MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Precisioncalc MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Precisioncalc MCP

High-precision finance & business calculations for AI agents — exact decimals, never floats.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "precisioncalc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "precisioncalc-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

PrecisionCalc MCP

A deterministic Model Context Protocol (MCP) server that gives LLM agents reliable, high-precision business, finance, and operational calculations.

v2 highlights: live + historical FX (ECB), 14 SaaS metrics, NPV/IRR, loan amortization, depreciation, a batch_calculate tool, per-country holidays, API-key auth + rate limiting + usage metering on the HTTP transport, structured JSON logging, optional OpenTelemetry tracing, and property-based tests.

🌐 Live hosted server (free, no install)

A public remote MCP server runs on Cloudflare's edge — point any Streamable-HTTP MCP client at it:

Code

https://precisioncalc-mcp.pages.dev/mcp

Install via npm (stdio, no hosting)

Run the server locally over stdio with a single command — nothing to deploy:

Terminal

npx -y precisioncalc-mcp

Claude Desktop / any stdio MCP client (claude_desktop_config.json):

config.json

{ "mcpServers": { "precisioncalc": { "command": "npx", "args": ["-y", "precisioncalc-mcp"] } } }

This is the same deterministic engine as the hosted server, running on your machine.

config.json

{ "mcpServers": { "precisioncalc": {
    "type": "http", "url": "https://precisioncalc-mcp.pages.dev/mcp" } } }

Plans (hosted endpoint)

Plan	Price	Daily calls	Live/historical FX	`batch_calculate`
Free (no key)	$0	15 / day (per IP)	❌ static only	❌
Starter	$12/mo	5,000 / day	✅	✅
Pro	$39/mo	50,000 / day	✅	✅

Rebuild/redeploy the edge server:

Terminal

npm install          # decimal.js + esbuild
npm run deploy       # bundles worker-src -> site/_worker.js and deploys to Pages

What it does

11 tools, all returning a uniform structured response:

Tool	Purpose
`calculate_metric`	14 SaaS/business metrics (LTV, CAC, churn, MRR growth, NRR, GRR, Rule of 40, magic number, break-even, ...)
`currency_convert`	Convert 9 major currencies; static (offline) or live/historical ECB rates
`business_days`	Add/count business days, next/previous; US/UK/EU + any ISO country + custom holidays
`compound_growth`	Future value, present value, CAGR; 7 compounding frequencies incl. continuous
`net_present_value`	NPV / discounted cash flow of a cashflow series
`internal_rate_of_return`	IRR (Newton + bisection fallback)
`loan_amortization`	Level-payment loan: payment, totals, full schedule, extra-payment payoff
`depreciation`	straight-line / declining-balance / sum-of-years-digits schedules
`batch_calculate`	Run many calculations in one request
`list_metrics`	Discovery: every metric with descriptions + required params
`health_check`	Server status, version, capabilities

Consistent response envelope

Success:

config.json

{
  "status": "success",
  "value": "1600",                       // exact, full-precision (string for money/rates)
  "formatted_value": "$1,600.00",        // human-readable
  "formula": "LTV = (ARPU * gross_margin) / churn_rate",
  "inputs_used": { "arpu": "100", "gross_margin": "0.8", "churn_rate": "0.05" },
  "unit": "USD",
  "notes": ["LTV = (ARPU x gross_margin) / churn_rate.", "..."]
}

Error (never raised across the tool boundary):

config.json

{
  "status": "error",
  "error": {
    "type": "missing_parameter",
    "message": "Missing required parameter 'churn_rate'.",
    "hint": "Include 'churn_rate' in params. See list_metrics for the full schema."
  }
}

Project structure

Code

precisioncalc-mcp/
├── server.py                 # MCP server: tool definitions + transports
├── security.py               # API-key auth + token-bucket rate limit + metering (ASGI)
├── observability.py          # Structured JSON logging + optional OpenTelemetry
├── requirements.txt / pyproject.toml
├── Dockerfile / .dockerignore
├── fly.toml / render.yaml    # One-click hosting configs
├── .env.example
├── calculations/
│   ├── _util.py              # Decimal coercion, validation, formatting
│   ├── metrics.py            # 14 business/SaaS metrics + catalog
│   ├── currency.py           # FX: static + Frankfurter (live/historical) providers
│   ├── business_days.py      # Region-aware holidays (built-in + `holidays` lib)
│   ├── growth.py             # FV / PV / CAGR
│   └── finance.py            # NPV / IRR / loan amortization / depreciation
├── schemas/responses.py      # Response envelope helpers
├── examples/agent_example.py # End-to-end MCP client demo
├── site/                     # Static landing/docs page (Cloudflare Pages)
└── tests/                    # 49 unit tests + Hypothesis property tests

Requirements

Python 3.11+ (developed/tested on 3.12)
Core: mcp, python-dateutil
Recommended: uvicorn + starlette (HTTP transport), holidays (per-country calendars)
Optional: opentelemetry-sdk (tracing), pytest + hypothesis (tests)

The server auto-detects the SDK layout and works with mcp >= 2.0 (MCPServer), mcp 1.x (FastMCP), or the standalone fastmcp package.

Run it locally

bash

cd precisioncalc-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt          # or: pip install -e ".[all]"

# stdio transport (default; how MCP clients launch it)
python server.py            # or: precisioncalc-mcp   (console entrypoint)

# Streamable HTTP transport (endpoint: /mcp)
python server.py http
PRECISIONCALC_API_KEYS=key1,key2 PRECISIONCALC_FX_PROVIDER=frankfurter python server.py http

Demo + tests:

bash

python examples/agent_example.py         # live end-to-end over stdio
python tests/test_calculations.py        # 28 core tests (no pytest needed)
python tests/test_v2.py                  # 17 v2 tests
python tests/test_properties.py          # Hypothesis property tests
# or simply:  pytest -q

Register with an MCP client (stdio)

config.json

{ "mcpServers": { "precisioncalc": {
    "command": "python", "args": ["/absolute/path/to/precisioncalc-mcp/server.py"] } } }

Deploy

Docker

Terminal

docker build -t precisioncalc-mcp .
docker run --rm -p 8000:8000 -e PRECISIONCALC_API_KEYS=your-key precisioncalc-mcp
docker run --rm -i precisioncalc-mcp python server.py stdio

Fly.io

Terminal

fly launch --no-deploy
fly secrets set PRECISIONCALC_API_KEYS=key1,key2
fly deploy

Render.com

Push to GitHub, then New + → Blueprint and point at the repo (render.yaml). Set PRECISIONCALC_API_KEYS as a secret in the dashboard.

Configuration (env vars)

Var	Default	Purpose
`PRECISIONCALC_HOST` / `PRECISIONCALC_PORT`	`127.0.0.1` / `8000`	HTTP bind
`PRECISIONCALC_API_KEYS`	(empty)	Comma-separated keys. Empty = open mode (still metered/limited by IP)
`PRECISIONCALC_RATE_LIMIT_PER_MIN` / `_BURST`	`120` / `40`	Token-bucket limits
`PRECISIONCALC_METRICS_PATH`	`/metrics`	Usage-metrics endpoint
`PRECISIONCALC_FX_PROVIDER`	`static`	`static` or `frankfurter` (live/historical ECB)
`PRECISIONCALC_FX_TTL` / `_TIMEOUT`	`3600` / `4`	FX cache TTL / HTTP timeout (s)
`PRECISIONCALC_LOG_LEVEL` / `_LOG_JSON`	`INFO` / `1`	Logging
`PRECISIONCALC_OTEL`	`0`	`1` enables OpenTelemetry tracing if SDK present

Tools & parameters

`calculate_metric(metric, params, currency="USD")`

Rates/margins are decimals (0.05 = 5%).

metric	params	unit
`ltv`	`arpu`, `churn_rate`, `gross_margin`(=1)	currency
`cac`	`total_spend`, `new_customers`	currency
`ltv_cac_ratio`	`ltv`, `cac`	ratio
`payback_period_months`	`cac`, `monthly_revenue_per_customer`, `gross_margin`(=1)	months
`contribution_margin`	`revenue`, `variable_costs`	currency
`gross_margin`	`revenue`, `cogs`	percent
`churn_rate`	`customers_lost`, `customers_at_start`	percent
`mrr_growth_rate`	`beginning_mrr`, `ending_mrr`	percent
`arr`	`mrr`	currency
`break_even_units`	`fixed_costs`, `price_per_unit`, `variable_cost_per_unit`	units
`nrr`	`starting_mrr`, `expansion_mrr`, `contraction_mrr`, `churned_mrr`	percent
`grr`	`starting_mrr`, `contraction_mrr`, `churned_mrr`	percent
`rule_of_40`	`growth_rate`, `profit_margin`	percent
`magic_number`	`current_quarter_revenue`, `prior_quarter_revenue`, `prior_quarter_sm_spend`	ratio

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Precisioncalc MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "precisioncalc-mcp": { "command": "npx", "args": ["-y", "precisioncalc-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/precisioncalc-mcp?style=directory)](https://allmcps.com/mcp/precisioncalc-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/precisioncalc-mcp"><img src="https://allmcps.com/api/badge/precisioncalc-mcp?style=directory" alt="Precisioncalc MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Precisioncalc MCP →Install in Claude Desktop Install in Cursor Install in VS Code