# Fiskalizimi — Albanian tax & payroll

Computes VAT, invoice totals and gross-to-net salary using Albanian 2026 rates. Runs offline, no API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed
- Author: square-al
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/square-al/fiskalizimi-utils/tree/HEAD/mcp
- Updated: 2026-08-30
- HTML: https://affpapa.org/en/nevibecode/mcp/fiskalizimi-albanian-tax-payroll

## What it does

The server hands an agent a set of calculators: NIPT/NUIS format checks, TVSH added to or pulled out of an amount at any rate (Albania 20 / 10 / 6 %, Kosovo 18 / 8 %), and invoice totals with the VAT split per rate. Payroll works both ways: gross to net and net to gross, broken into employee contributions, progressive income tax and employer cost. Profit tax has its own tool, and `tax_rates` returns the whole rate and bracket config.

Nothing goes over the network and no keys are involved because the arithmetic happens on your machine. Rates were checked against tatime.gov.al; the verification date and the caveats sit in the `notes` of `tax_rates`. Read them before trusting a salary figure that lands in the 50,000–60,000 ALL monthly transitional band.

Two install paths. Claude Desktop users download `fiskalizimi-mcp.mcpb` from the latest release and open it. Any stdio client needs a build first: `npm ci` and `npm run build` at the repo root, the same inside `mcp`, then point the MCP config at `mcp/dist/main.js` with `node`. Skip the build and the client has no file to launch.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- check a NIPT's format and catch O/0 and I/1 typos
- pull TVSH out of a total at 20, 10 or 6 %
- build invoice totals with a VAT breakdown per rate
- turn a gross salary into net with contributions and income tax
- work out corporate profit tax across brackets

## Example prompts
- Validate `m5141 8039h` as a NIPT and tell me what 120000 lek gross leaves in hand
- Run `invoice_totals` for a two-line invoice with a per-line discount
- Convert a net of 80000 ALL to gross with `gross_salary_from_net` and show the breakdown

## Similar
- [plan-payroll](https://affpapa.org/en/nevibecode/skills/plan-payroll.md) — skill · 1800 installs
- [uk-finance-accounting](https://affpapa.org/en/nevibecode/plugins/uk-finance-accounting.md) — plugin · ★ 5
- [Avalara Tax Registrations and Business Licenses](https://affpapa.org/en/nevibecode/mcp/avalara-tax-registrations-and-business-licenses.md) — MCP server · ★ 5
- [tax-prep](https://affpapa.org/en/nevibecode/skills/tax-prep.md) — skill · 1800 installs
- [shopify-tax-compliance](https://affpapa.org/en/nevibecode/skills/shopify-tax-compliance.md) — skill · 1000 installs
- [tax-efficiency](https://affpapa.org/en/nevibecode/skills/tax-efficiency.md) — skill · 690 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md