Fiskalizimi — Albanian tax & payroll

al.squarePublished by square.alv0.2.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Offline, read-only calculators for Albanian fiscalization and payroll: NIPT validation, TVSH math, invoice totals, salary and profit tax.

What you can do
  • Validate and normalize Albanian NIPT/NUIS numbers, flagging O/0 and I/1 typos
  • Compute TVSH (VAT) additions and extractions at Albanian and Kosovo rates
  • Build invoice totals with per-rate VAT breakdown and per-line discounts
  • Convert gross to net and net to gross monthly salary with social, health and income tax
  • Calculate corporate profit tax across progressive brackets
  • Return the verified AL-2026 rate configuration with sources and limitations
When to use it
Useful when an assistant has to check Albanian business identifiers or do Albanian VAT, invoice, payroll or profit-tax arithmetic, especially for POS, ERP or e-commerce work in Albania. It is a calculator, not a filing or fiscalization client.
Requirements
Runs locally over stdio, either as a Claude Desktop .mcpb bundle or from a Node.js checkout built with npm. No network access, API keys or accounts are needed.
Before you install
Results are only as current as the bundled AL-2026 rates; the README warns to read the notes in tax_rates before relying on net-salary results in the 50,000–60,000 ALL transitional band. It does not submit anything to tax authorities.

Installation

In SourceWeft

  1. Open Fiskalizimi — Albanian tax & payroll in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

fiskalizimi MCP server (al.square/fiskalizimi)

An MCP server that gives AI agents offline, read-only calculators for Albanian fiscalization and payroll, built on fiskalizimi-utils and maintained by Square Software, a software company in Tirana that ships fiscalization integrations for POS, ERP and e-commerce systems.

No network access, no API keys, nothing leaves the machine.

Tools

ToolWhat it does
validate_niptFormat-check a NIPT/NUIS (M51418039H), normalize separators, flag O/0 and I/1 typos, link to the QKB lookup
add_vat / extract_vatTVSH math at any rate — Albania 20 / 10 / 6 %, Kosovo 18 / 8 %
invoice_totalsSubtotal, VAT and grand total with the per-rate VAT breakdown a fiscalized invoice must report; per-line discounts
net_salaryGross → net monthly salary: employee social 9.5 % + health 1.7 %, progressive income tax 0 / 13 / 23 %, employer cost
gross_salary_from_netNet → gross, same breakdown
profit_taxCorporate profit tax over the progressive brackets (0 % to 14,000,000 ALL, 15 % above)
tax_ratesThe verified AL-2026 config: rates, caps, brackets, deadlines, source, verification date, disclosed limitations

Resource: fiskalizimi://rates/AL-2026 (JSON).

The numbers are the same ones behind our free online tools — Verifikues NIPT, Llogaritësi i TVSH-së, Llogaritësi i pagës — verified on 2026-06-29 against tatime.gov.al. Read the notes in tax_rates before relying on net-salary results in the 50,000–60,000 ALL/month transitional band.

Install

Claude Desktop — download fiskalizimi-mcp.mcpb from the latest release and open it.

Any MCP client (stdio) — from a checkout:

bash
git clone https://github.com/square-al/fiskalizimi-utils && cd fiskalizimi-utilsnpm ci && npm run buildcd mcp && npm ci && npm run build
json
{  "mcpServers": {    "fiskalizimi": { "command": "node", "args": ["/path/to/fiskalizimi-utils/mcp/dist/main.js"] }  }}

Or run the single-file bundle that ships inside the .mcpb (it is a zip): node server/index.js.

Example

"Is m5141 8039h a valid NIPT, and what does a 120,000 lek gross salary leave in hand?"

validate_nipt  → { valid: true, normalized: "M51418039H", parts: { prefix: "M", … } }net_salary     → { gross: 120000, empSocial: 11400, empHealth: 2040, incomeTax: 7352.8, net: 99207.2, employerCost: 140040, … }

Development

bash
npm test          # in-memory client ↔ server round-tripsnpm run bundle    # esbuild → bundle/ (single CommonJS file + manifest)npx @anthropic-ai/mcpb pack bundle dist/fiskalizimi-mcp.mcpb

server.json is the official-registry descriptor; PUBLISHING.md at the repo root has the release steps.

MIT © Square Software SHPK

Source: mcp/README.md at commit fde2732

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts