Financial Calculator MCP Server

A comprehensive Model Context Protocol (MCP) server providing professional financial and audit calculations with audit-grade explainability.

Features

• 25 Professional Financial Calculations across multiple domains
• Audit-Grade Explainability with formulas, substitutions, and step-by-step breakdowns
• Deterministic Calculations with proper precision and rounding
• Comprehensive Error Handling with validation and business rule enforcement
• Accounting Standards References where applicable
• MCP Protocol Compliant for seamless integration

Available Calculations

Core Arithmetic & Business Math

• Percentage calculations
• Ratio analysis

Financial Statement Analysis

• Current ratio, Return on equity, Debt-to-equity ratio
• Gross/net profit margins, Asset turnover, Inventory turnover
• Days sales outstanding

Audit Planning & Risk

• Materiality threshold calculations

Depreciation & Amortization

• Straight-line depreciation
• Declining balance depreciation
• Units of production depreciation

Time Value of Money

• Present value calculations
• Future value of annuities
• Net present value (NPV)

Tax & Deferred Tax

• Deferred tax calculations
• Effective tax rate analysis
• Taxable income computations

Variance & Analytical Procedures

• Percentage variance analysis

Statistical Calculations

• Mean (arithmetic average)
• Standard deviation (population/sample)

Working Capital Management

• Working capital calculations
• Cash conversion cycle analysis

Cost Analysis

• Break-even point analysis
• Economic order quantity (EOQ)

Financial Health Indicators

• Altman Z-Score for bankruptcy prediction

Economic Adjustments

• Inflation-adjusted value calculations

Installation

From npm (Recommended)

npm install -g @vasanth0475/financial-calculator-mcp

Usage

As a Global Command

financial-calculator-mcp

In MCP Configuration

Add to your MCP settings:

{
  "mcpServers": {
    "financial-calculator": {
      "command": "financial-calculator-mcp",
      "args": [],
      "env": {}
    }
  }
}

In Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "financial-calculator": {
      "command": "financial-calculator-mcp"
    }
  }
}

In VS Code Cline

Add to cline_mcp_settings.json:

{
  "mcpServers": {
    "financial-calculator": {
      "command": "financial-calculator-mcp",
      "args": []
    }
  }
}

Example Queries

Once configured, you can ask natural language questions like:

• "Calculate current ratio with current assets 1,000,000 and current liabilities 500,000"
• "Compute materiality at 5% of profit before tax of 2,000,000"
• "Find the return on equity for net income 500,000 and shareholder equity 2,500,000"
• "Calculate break-even point with fixed costs 100,000, selling price 50, variable cost 30"
• "Determine the economic order quantity for annual demand 10,000, ordering cost 100, carrying cost 5"

Response Format

Each calculation returns structured JSON with:

{
  "calculation_id": "unique_calculation_id",
  "timestamp": "ISO_timestamp",
  "formula": "Mathematical formula used",
  "substitution": "Values plugged into formula",
  "steps": ["Step-by-step breakdown"],
  "result": "Final calculated value",
  "explanation": "Business interpretation",
  "references": ["Accounting standards"],
  "audit_trail": {
    "precision_used": "decimal places",
    "rounding_method": "rounding technique"
  }
}

Development

Prerequisites

• Node.js >= 18.0.0
• TypeScript >= 5.0.0

Building

npm run build

Development Mode

npm run dev

API Reference

Tool Categories

All tools follow consistent naming and parameter conventions:

• Input validation with business rule enforcement
• Type safety with proper error handling
• Deterministic results for audit compliance
• Professional precision (2 decimal places standard)

Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new calculations
4. Ensure TypeScript compilation passes
5. Submit a pull request

License

MIT License - see LICENSE file for details

Professional Use

This MCP server is designed for professional audit, finance, and compliance environments. All calculations include:

• ✅ Audit trails with calculation metadata
• ✅ Accounting standard references where applicable
• ✅ Business rule validation preventing invalid calculations
• ✅ Deterministic results ensuring reproducibility
• ✅ Professional precision handling financial data appropriately