CalcBloc tax and salary calculator
Take-home pay, employer cost and official tax tables for many countries via MCP
- 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-mcpAdd 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.