Skip to content
MCP server

CalcBloc tax and salary calculator

Take-home pay, employer cost and official tax tables for many countries via MCP

Runs locally
Install
Pricing
Free
Platforms
API, CLI
Runs
Locally
Version
0.1.3
Listing updated
5 days ago

Similar MCP servers

About CalcBloc tax and salary calculator

CalcBloc tax and salary calculator is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CALCBLOC_API_KEYOptional; needed after 50 requests/day. Free key from https://calcbloc.com/developers/keys (5,000 requests/day).
  • CALCBLOC_DATA_DIROptional folder with the CalcBloc tax-table data (https://calcbloc.com/data) for offline tax tables.

What it does

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

Pricing

Free

Free; optional free key raises the limit to 5,000 requests a day

Prices change. Check calcbloc.com before you buy.

CalcBloc tax and salary calculator 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.

How AIPoweredBot checks servers