Fiskalizimi — Albanian tax & payroll

al.square由 square.al 发布v0.2.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向阿尔巴尼亚财税与薪资的离线只读计算器：NIPT 校验、TVSH 税额计算、发票合计、工资与利润税。

可以做什么
  • 校验并规范化阿尔巴尼亚 NIPT/NUIS 编号，提示 O/0、I/1 等录入错误
  • 按阿尔巴尼亚和科索沃税率计算 TVSH（增值税）的加税与含税拆分
  • 生成含分税率增值税明细和行级折扣的发票合计
  • 在毛额与净额之间换算月薪，含社保、医保与所得税
  • 按累进档位计算企业所得税
  • 返回经核验的 AL-2026 税率配置，含来源与局限说明
适用场景
适合需要核对阿尔巴尼亚企业标识，或进行阿尔巴尼亚增值税、发票、薪资、利润税计算的场景，例如当地的 POS、ERP 与电商业务。它只是计算器，不是申报或电子开票客户端。
运行要求
以 stdio 在本地运行，可用 Claude Desktop 的 .mcpb 包，或用 npm 构建的 Node.js 源码运行。无需联网、API 密钥或账号。
安装前请注意
结果取决于内置的 AL-2026 税率；README 提醒在依赖 50,000–60,000 ALL 过渡区间的净工资结果前先阅读 tax_rates 中的 notes。它不会向税务机关提交任何内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fiskalizimi — Albanian tax & payroll，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：mcp/README.md，提交 fde2732

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分