TaxCompass
    For developers · Model Context Protocol

    Let your AI agent use TaxCompass's Italian tax tools

    Connect Claude, Cursor or any MCP client to TaxCompass and your agent can search Italian tax & company law (grounded in primary sources, with citations) and run a real tax engine — without leaving your editor. Free, read-only, no key.

    New to MCP? It's the open standard that lets AI assistants like Claude call external tools. If that means nothing to you, you probably want the chat instead.

    https://api.taxcompass.it/mcp
    Add it to your agent

    What it looks like

    You

    I'm a freelance consultant moving to Italy. What would I pay in tax on €50,000 under the forfettario?

    Claude · with TaxCompass

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

    On €50,000 your taxable base is €39,000 (78% coefficient). After ~€10,167 INPS Gestione Separata, the 15% substitute tax is ~€4,325 — so your net is ≈ €35,508 (effective rate ~29%). The 5% starter rate would leave ≈ €38,391.

    Sources cited inline: Agenzia delle Entrate · Legge 190/2014 (each a real URL your agent can open).

    Why not just ask the model directly?

    Because Italian tax is exactly where general models are least reliable — specific, numeric, and changing every year.

    Model from memory
    • Guesses rates and thresholds, often from an old tax year.
    • No citation — you can't check where a number came from.
    • Does the arithmetic itself, so totals drift.
    With TaxCompass
    • Grounded in current primary law — Normattiva, AdE, INPS.
    • Every figure carries a source URL to open and verify.
    • Numbers come from a deterministic engine, not the model.

    The tools

    Four read-only tools. Search returns cited passages; the calculators are pure, deterministic math.

    search_italian_tax_sources

    Hybrid semantic + keyword search over the primary-source corpus. Returns passages with a source URL to cite — Normattiva, Agenzia delle Entrate, INPS, the pinned tax-year tables, ATECO and EU/treaty sources.

    list_tax_sources

    The catalogue of searchable sources and what each one covers — so your agent knows the valid filters and the corpus's coverage.

    calculate_italian_tax

    Exact, deterministic tax for one regime (forfettario 5%/15%, ordinario, impatriati): substitute/income tax, INPS, net income, effective rate and eligibility. Not an estimate.

    compare_italian_regimes

    All Italian regimes side by side at a given revenue, ranked by net income — the deterministic answer to “which regime should I be in?”

    Install

    It's a remote streamable-HTTP server — point any MCP client at the endpoint. No install, no auth. (Client config formats change; check your client's MCP docs if a snippet looks dated.)

    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" }
  }
}
    Then try asking your agent: “Using TaxCompass, what's the forfettario revenue limit, and what tax would I pay on €60k as a software developer?”
    Read-only — no writes, no account Free, rate-limited per IP Queries not stored · EU-resident

    Questions

    What is the TaxCompass MCP server?

    A free, read-only Model Context Protocol (MCP) server that lets AI assistants like Claude and Cursor call TaxCompass's Italian tax tools directly inside your agent — searching primary sources (Normattiva, Agenzia delle Entrate, INPS) and running a deterministic forfettario / IRPEF / INPS tax engine.

    Why use it instead of asking ChatGPT or Claude directly?

    General models answer Italian tax questions from memory — often out of date, and with no citation you can check. The MCP grounds every answer in current primary law (with source URLs) and computes the numbers with a real tax engine, not the model's arithmetic. Same sourced approach as taxcompass.it, inside your own agent.

    How do I connect it to Claude or Cursor?

    Point any MCP client at https://api.taxcompass.it/mcp. In Claude Code: `claude mcp add --transport http taxcompass https://api.taxcompass.it/mcp`. For Claude Desktop or Cursor, add the server to your client's MCP config. No account or API key.

    Is it free, and is my data stored?

    Yes, free — read-only, no signup, no API key. It's rate-limited per IP, and your search queries are not stored. It runs on EU-resident infrastructure.

    What does it cover?

    The forfettario (5% and 15%), ordinario and impatriati regimes; IRPEF, INPS Gestione Separata, forfettario thresholds and coefficienti di redditività; the ATECO 2025 code catalogue; plus EU and double-taxation-treaty sources for cross-border questions.

    Is this tax advice?

    No. It's grounded orientation for AI agents — sourced and exact, but not a substitute for a professional. Verify with a licensed commercialista before filing.

    Prefer not to wire it up?

    Ask TaxCompass directly — same sources, same engine, in your browser.

    Open the chat