# CalcBloc tax and salary calculator

> CalcBloc tax and salary calculator is a free MCP server for finance and payments. Take-home pay, employer cost and official tax tables for many countries via MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://calcbloc.com/developers
- **Repository:** https://github.com/itmarkerz/calcbloc-mcp
- **MCP Registry name:** io.github.itmarkerz/calcbloc-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

Answers come from the same calculation engines that power the CalcBloc website, so an assistant can return net pay, taxes and contributions instead of estimating them from memory. Each figure in the tax tables carries its effective date and the official source it was taken from.

The server runs locally over stdio and installs from npm as calcbloc-mcp. It works without a key for up to 50 requests a day; a free key from the CalcBloc developer page raises that to 5,000 requests a day. An optional data folder lets the tax tables be read offline.

Under the hood it wraps the CalcBloc JSON API, which rejects unknown parameters with a 400 and reports clamped out-of-range numbers in warnings, so typos do not slip through quietly.

## Features

- **Take-home pay:** Runs a country's net salary engine and returns net pay, taxes and contributions.
- **Employer cost:** Adds employer social security, payroll taxes, pension and other on-costs to a salary.
- **Two-country comparison:** Converts one salary at the European Central Bank reference rate and runs both countries' engines.
- **Official tax tables:** Returns income tax bands, thresholds and contribution rates by country and year, with sources.
- **Regional rules:** Accepts a US state, Canadian province or territory, Scotland or Wales for region-specific tables.
- **Offline option:** Reads a local CalcBloc data folder when you do not want live calls.

## Good for

- Estimate the net pay of a job offer in another country
- Work out the total cost of hiring someone abroad
- Compare the same salary in two countries
- Look up the tax bands for a given tax year with their official source

## Install

### Claude Code (Terminal)

```sh
claude mcp add calcbloc-mcp --env CALCBLOC_API_KEY='<CALCBLOC_API_KEY>' -- npx -y calcbloc-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "calcbloc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "calcbloc-mcp"
      ],
      "env": {
        "CALCBLOC_API_KEY": "<CALCBLOC_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "calcbloc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "calcbloc-mcp"
      ],
      "env": {
        "CALCBLOC_API_KEY": "<CALCBLOC_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "calcbloc-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "calcbloc-mcp"
      ],
      "env": {
        "CALCBLOC_API_KEY": "<CALCBLOC_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "calcbloc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "calcbloc-mcp"
      ],
      "env": {
        "CALCBLOC_API_KEY": "<CALCBLOC_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "calcbloc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "calcbloc-mcp"
      ],
      "env": {
        "CALCBLOC_API_KEY": "<CALCBLOC_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need an API key?

Not to start. Without a key you get 50 requests a day; a free key lifts the limit to 5,000 a day.

### Can it work offline?

Partly. Point CALCBLOC_DATA_DIR at a folder with the CalcBloc tax-table data to read the tax tables offline.

### Is attribution required?

The developer page asks for a visible 'Data by CalcBloc' link to calcbloc.com wherever you display the figures.

### Is CalcBloc tax and salary calculator free?

Yes. CalcBloc tax and salary calculator is free to use.

### How do I add CalcBloc tax and salary calculator to Claude Code?

Run this command in your terminal: claude mcp add calcbloc-mcp --env CALCBLOC_API_KEY='<CALCBLOC_API_KEY>' -- npx -y calcbloc-mcp

### What are the best alternatives to CalcBloc tax and salary calculator?

The closest alternatives to CalcBloc tax and salary calculator are Estimate My Paycheck, CalcBright Calculators, AuraCalcs, DecisionsCalc calculators and SalaryNet Payroll.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Estimate My Paycheck](https://ai-powered.com/mcp/estimate-my-paycheck): Estimate My Paycheck is a free MCP server for finance and payments.
- [CalcBright Calculators](https://ai-powered.com/mcp/calcbright-calculators): CalcBright Calculators is a free MCP server for finance and payments.
- [AuraCalcs](https://ai-powered.com/mcp/auracalcs): AuraCalcs is a free MCP server for finance and payments.
- [DecisionsCalc calculators](https://ai-powered.com/mcp/decisionscalc-calculators): DecisionsCalc calculators is a free MCP server for finance and payments.
- [SalaryNet Payroll](https://ai-powered.com/mcp/salarynet-payroll): SalaryNet Payroll is a freemium MCP server for finance and payments.
- [Simulateurs salaire et freelance (France)](https://ai-powered.com/mcp/simulateurs-salaire-et-freelance-france): Simulateurs salaire et freelance (France) is an open-source MCP server for finance and payments.
- [Cuelark Tools](https://ai-powered.com/mcp/cuelark-tools): Cuelark Tools is a free MCP server for developer tools.
- [PayCalculator](https://ai-powered.com/mcp/paycalculator): PayCalculator is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/calcbloc-tax-and-salary-calculator
