# Fiskalizimi — Albanian tax & payroll [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/square-al/fiskalizimi-utils  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/fiskalizimi-albanian-tax-payroll

## Description
Albanian NIPT validation, TVSH (VAT) & invoice math, gross↔net payroll on verified 2026 rates.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "fiskalizimi-albanian-tax-payroll": {
    "command": "uvx",
    "args": ["fiskalizimi-utils"]
  }
}
```

## Documentation

## What Fiskalizimi — Albanian tax & payroll MCP server does

Fiskalizimi — Albanian tax & payroll MCP server packages the project’s fiscalization and payroll utilities as tools for AI agents. Its scope covers format-level NIPT/NUIS validation, VAT calculations, fiscal invoice totals, gross-to-net and net-to-gross salary calculations, profit tax, and access to the configured tax rates.

NIPT validation normalizes separators and letter case, checks the expected structure, and reports issues such as non-numeric digits or a likely typo. It does not confirm that a well-formed identifier exists in the official QKB registry. VAT helpers can add or extract tax using supported rates, while invoice calculations return totals and a VAT breakdown by rate.

## How it works

The MCP implementation is contained in the repository’s `mcp/` directory and wraps the underlying pure functions. Calls are handled locally, with no network request required. A standard stdio MCP client can launch `node mcp/dist/main.js`; Claude Desktop users can install the `.mcpb` package from a release, and the server is also listed in the MCP registry as `al.square/fiskalizimi`.

Payroll calculations use the `AL_2026` configuration. The README states that these rates were verified against tatime.gov.al on 2026-06-29 and that the configuration is dated and marked verified. The tools expose the resulting calculations rather than retrieving current rates at request time, so rate changes require an updated configuration or confirmation from the tax authority.

## Setup and configuration

Install the MCP bundle from the project’s releases for Claude Desktop, or use the MCP registry identifier where supported. For another stdio-compatible client, build or obtain the distribution and start `node mcp/dist/main.js` according to the repository’s MCP instructions. No runtime environment variables are documented as required.

The wider project can also be installed with `npm install fiskalizimi-utils`, `pip install fiskalizimi-utils`, or through the JSR package. Docker runs the CLI with `docker run --rm squaresoftware/fiskalizimi --help`, but the MCP usage path is the stdio server rather than the CLI.

## Tools and capabilities

Fiskalizimi — Albanian tax & payroll MCP server provides these named tools:

- `validate_nipt` checks and normalizes an Albanian NIPT/NUIS format.
- `add_vat` adds VAT to a net amount.
- `extract_vat` separates VAT from a gross amount.
- `invoice_totals` calculates invoice totals and groups the VAT base and amount by rate.
- `net_salary` calculates net salary and related employee and employer amounts from gross salary.
- `gross_salary_from_net` estimates the gross salary needed for a target net amount.
- `profit_tax` calculates profit tax using the configured bands.
- `tax_rates` returns the configured rates.

The underlying project also includes Python and TypeScript libraries, command-line subcommands, and an open-data package containing rates, contribution figures, VAT rates, wage information, and filing deadlines.

## Limitations and notes

NIPT validation is structural only; it does not establish registration with QKB. The payroll configuration documents an approximation in the personal-income-tax transition band around 50,000–60,000 ALL per month. The README also describes severance figures as orienting values, although severance is not listed among the MCP tools.

Tax rules and rates can change. Confirm results with the relevant authority before using them for invoicing, payroll, or compliance decisions. The project explicitly states that its calculations are not tax or legal advice. The tool performs local calculations and should not be treated as a live connection to Albanian tax systems.

_Full upstream README: https://allmcps.com/mcp/fiskalizimi-albanian-tax-payroll/readme_