Fiskalizimi — Albanian tax & payroll

fiskalizimi MCP サーバー（al.square/fiskalizimi）

AI エージェントにアルバニアの電子インボイス制度と給与計算のオフライン読み取り専用計算ツールを提供するMCPサーバーです。fiskalizimi-utilsを基盤としており、POS、ERP、eコマースシステム向けの電子インボイス制度連携を提供する、ティラナのソフトウェア会社Square Softwareが保守しています。

ネットワークアクセスもAPIキーも不要で、データがマシンの外に出ることはありません。

ツール

ツール	内容
validate_nipt	NIPT/NUIS（M51418039H）の形式をチェックし、区切り文字を正規化し、O/0とI/1の入力ミスを検出して、QKBの検索ページにリンクします
add_vat / extract_vat	任意の税率でTVSHを計算します。アルバニアは20／10／6％、コソボは18／8％です
invoice_totals	小計、VAT、合計を計算します。電子インボイスの報告に必要な税率ごとのVAT内訳と、明細ごとの割引にも対応します
net_salary	月額総支給額から手取り額を計算します。従業員の社会保険料9.5％＋健康保険料1.7％、累進所得税0／13／23％、雇用主負担額を含みます
gross_salary_from_net	手取り額から総支給額を計算します。同じ内訳を表示します
profit_tax	累進税率区分に基づいて法人利益税を計算します（14,000,000 ALLまでは0％、超過分は15％）
tax_rates	検証済みのAL-2026設定を表示します。税率、上限額、税率区分、期限、出典、検証日、開示された制限事項を含みます

リソース：fiskalizimi://rates/AL-2026（JSON）。

計算に使われる数値は、無料のオンラインツールであるVerifikues NIPT、Llogaritësi i TVSH-së、Llogaritësi i pagësと同じです。tatime.gov.alに照らし、2026-06-29に検証済みです。月額50,000～60,000 ALLの移行期間における手取り額を利用する前に、tax_ratesのnotesを確認してください。

インストール

Claude Desktop — 最新リリースからfiskalizimi-mcp.mcpbをダウンロードして開きます。

任意のMCPクライアント（stdio） — リポジトリのチェックアウトから実行します。

git clone https://github.com/square-al/fiskalizimi-utils && cd fiskalizimi-utils
npm ci && npm run build
cd mcp && npm ci && npm run build

{
  "mcpServers": {
    "fiskalizimi": { "command": "node", "args": ["/path/to/fiskalizimi-utils/mcp/dist/main.js"] }
  }
}

または、.mcpbに同梱されている単一ファイルのバンドル（zip形式）を実行します：node server/index.js。

使用例

「m5141 8039hは有効なNIPTですか？また、総支給額が120,000レクの場合、手取りはいくらですか？」

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, … }

開発

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

server.jsonは公式レジストリ用の記述ファイルです。リポジトリのルートにあるPUBLISHING.mdにリリース手順が記載されています。

MIT © Square Software SHPK