Przejdź do treści głównej
Dla programistów · Model Context Protocol

Pozwól swojemu agentowi AI korzystać z włoskich narzędzi podatkowych TaxCompass

Podłącz Claude, Cursor lub dowolnego klienta MCP do TaxCompass, a Twój agent przeszuka włoskie prawo podatkowe i gospodarcze (w oparciu o źródła pierwotne, z cytatami) i uruchomi prawdziwy silnik podatkowy — bez wychodzenia z edytora. Bezpłatnie, tylko do odczytu, bez klucza.

Nie znasz MCP? To otwarty standard, dzięki któremu asystenci AI tacy jak Claude wywołują zewnętrzne narzędzia. Jeśli nic Ci to nie mówi, prawdopodobnie szukasz raczej czatu.

https://api.taxcompass.it/mcp
Dodaj to do swojego agenta

Jak to wygląda

Ty

Jestem niezależnym konsultantem przeprowadzającym się do Włoch. Ile zapłacę podatku od 50 000 € w reżimie forfettario?

Claude · z TaxCompass

→ calculate_italian_tax(revenue_eur=50000, regime="forfettario_15")
→ search_italian_tax_sources("forfettario regime aliquota 15% Legge 190/2014")

Przy 50 000 € podstawa opodatkowania wynosi 39 000 € (współczynnik 78%). Po około 10 167 € składek INPS Gestione Separata podatek zryczałtowany 15% to około 4 325 €, więc na rękę zostaje ≈ 35 508 € (stawka efektywna ~29%). Przy startowej stawce 5% zostałoby ≈ 38 391 €.

Źródła cytowane w treści: Agenzia delle Entrate · Legge 190/2014 (każde to prawdziwy adres, który Twój agent może otworzyć).

Dlaczego nie zapytać modelu wprost?

Bo włoskie podatki to dokładnie ten obszar, w którym modele ogólnego przeznaczenia są najmniej wiarygodne: szczegółowy, liczbowy i zmieniany co roku.

Model z pamięci
  • Zgaduje stawki i progi, często z dawnego roku podatkowego.
  • Bez cytatu — nie sprawdzisz, skąd wzięła się dana liczba.
  • Sam wykonuje obliczenia, więc sumy odchodzą od prawdy.
Z TaxCompass
  • Oparte na obowiązujących przepisach: Normattiva, AdE, INPS.
  • Każda kwota ma adres źródła, który otworzysz i zweryfikujesz.
  • Liczby pochodzą z deterministycznego silnika, nie od modelu.

Narzędzia

Cztery narzędzia tylko do odczytu. Wyszukiwarka zwraca fragmenty ze źródłem, a kalkulatory to czysta, deterministyczna matematyka.

search_italian_tax_sources

Hybrydowe wyszukiwanie semantyczne i słowo po słowie w korpusie źródeł pierwotnych. Zwraca fragmenty wraz z adresem źródła do zacytowania: Normattiva, Agenzia delle Entrate, INPS, przypisane tabele roku podatkowego, ATECO oraz źródła unijne i traktatowe.

list_tax_sources

Katalog przeszukiwanych źródeł i zakres każdego z nich, dzięki czemu Twój agent zna dopuszczalne filtry i wie, jak daleko sięga korpus.

calculate_italian_tax

Dokładny, deterministyczny podatek dla jednego reżimu (forfettario 5%/15%, ordinario, impatriati): podatek zryczałtowany lub dochodowy, INPS, kwota netto, stawka efektywna i warunki. To nie jest szacunek.

compare_italian_regimes

Wszystkie włoskie reżimy zestawione przy danym przychodzie i uszeregowane według kwoty netto — deterministyczna odpowiedź na pytanie „w jakim reżimie powinienem być?”

Instalacja

To zdalny serwer streamable HTTP — wskaż endpoint dowolnemu klientowi MCP. Bez instalacji, bez logowania. (Formaty konfiguracji klientów się zmieniają; jeśli fragment wygląda na przestarzały, sprawdź dokumentację MCP swojego klienta.)

Claude Code

claude mcp add --transport http taxcompass https://api.taxcompass.it/mcp

Claude Desktop

{
  "mcpServers": {
    "taxcompass": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.taxcompass.it/mcp"]
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "taxcompass": { "url": "https://api.taxcompass.it/mcp" }
  }
}
Potem spróbuj zapytać swojego agenta: „Korzystając z TaxCompass, jaki jest limit przychodów w reżimie forfettario i ile podatku zapłacę od 60 000 € jako programista?”
Tylko do odczytu — bez zapisu, bez konta Bezpłatnie, z limitem zapytań na adres IP Zapytania nie są przechowywane · infrastruktura w UE

Pytania

Czym jest serwer MCP TaxCompass?

Bezpłatnym serwerem Model Context Protocol (MCP) tylko do odczytu, dzięki któremu asystenci AI tacy jak Claude i Cursor wywołują włoskie narzędzia podatkowe TaxCompass wprost w Twoim agencie: przeszukują źródła pierwotne (Normattiva, Agenzia delle Entrate, INPS) i uruchamiają deterministyczny silnik podatkowy forfettario / IRPEF / INPS.

Po co go używać zamiast pytać wprost ChatGPT albo Claude?

Modele ogólnego przeznaczenia odpowiadają na pytania o włoskie podatki z pamięci — często nieaktualnie i bez cytatu, który dałoby się sprawdzić. MCP opiera każdą odpowiedź na obowiązujących przepisach (z adresem źródła) i liczy prawdziwym silnikiem podatkowym, a nie arytmetyką modelu. To samo podejście co na taxcompass.it, tyle że w Twoim agencie.

Jak podłączyć go do Claude albo Cursora?

Wskaż dowolnemu klientowi MCP adres https://api.taxcompass.it/mcp. W Claude Code: `claude mcp add --transport http taxcompass https://api.taxcompass.it/mcp`. W Claude Desktop lub Cursorze dodaj serwer do konfiguracji MCP swojego klienta. Bez konta i bez klucza API.

Czy jest bezpłatny i czy moje dane są przechowywane?

Tak, jest bezpłatny: tylko do odczytu, bez rejestracji, bez klucza API. Obowiązuje limit zapytań na adres IP, a Twoje zapytania nie są przechowywane. Działa na infrastrukturze zlokalizowanej w Unii Europejskiej.

Co obejmuje?

Reżimy forfettario (5% i 15%), ordinario oraz impatriati; IRPEF, INPS Gestione Separata, progi i współczynniki dochodowości forfettario; katalog kodów ATECO 2025; a do tego źródła unijne i umowy o unikaniu podwójnego opodatkowania na pytania transgraniczne.

Czy to doradztwo podatkowe?

Nie. To orientacja oparta na źródłach, przeznaczona dla agentów AI: udokumentowana i dokładna, ale niezastępująca profesjonalisty. Przed złożeniem czegokolwiek potwierdź u licencjonowanego commercialisty.

Wolisz niczego nie podłączać?

Zapytaj TaxCompass wprost: te same źródła, ten sam silnik, w przeglądarce.

Otwórz czat