Server definition
- Hash
- sha256:206a634ef38b927b725755898ee9e0a78d52e38855d7205d282db1e452148b5b
- What it is
- What a remote MCP server returned when asked what it offers: 4 tools
The blob, as servednamed by its sha256
{
"instructions": "TaxCompass — sourced Italian tax & company-law tools for AI agents.\n\nTaxCompass (https://taxcompass.it) is an AI tax co-pilot for foreign founders and freelancers opening a business in Italy (forfettario-first, English-native). This server exposes the same primary-source corpus and deterministic tax engine that power the product, so you can answer Italian tax questions that are grounded and citable rather than guessed.\n\nHow to use it well:\n- `search_italian_tax_sources` retrieves passages from primary sources — Normattiva (statute), Agenzia delle Entrate (circolari & guidance), INPS (social security), the pinned tax-year tables (IRPEF brackets, INPS rates, forfettario thresholds & coefficienti di redditività), the ATECO 2025 code catalogue, and EU/treaty sources. Every passage carries a `chunk_id`, `source`, and (usually) a `url`. Cite the `url` and quote the text; do NOT assert Italian tax facts the passages don't support.\n- `list_tax_sources` shows what the corpus covers and the valid `sources` filter values.\n- `calculate_italian_tax` and `compare_italian_regimes` give exact, deterministic numbers (substitute tax, IRPEF, INPS, effective rate) — real calculations, not estimates.\n\nThis is grounded orientation, NOT tax advice (Art. 348 c.p.). Surface the citations and recommend the user confirm with a licensed commercialista before filing.\n",
"tools": [
{
"description": "Compute exact Italian tax for one regime at a given annual revenue.\n\n Deterministic calculation (not an estimate): substitute/income tax, INPS\n social contributions, net income, and effective rate. `breakdown.eligible`\n is False when the regime doesn't apply to the inputs (e.g. forfettario above\n the €85k cap) — present that as \"not eligible\", not as a real option.\n\n Args:\n revenue_eur: Gross annual revenue in EUR.\n regime: One of `forfettario_5`, `forfettario_15`, `ordinario`,\n `ordinario_impatriati`.\n coefficient: Forfettario coefficiente di redditività (0.40–0.86, set by\n the activity's ATECO group). Omit for the professional-services\n default (0.78). Ignored by non-forfettario regimes.\n cost_ratio: Deductible costs as a fraction of revenue (0–1), used by\n ordinario/impatriati. Ignored by forfettario.\n ",
"inputSchema": {
"properties": {
"coefficient": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Coefficient"
},
"cost_ratio": {
"default": 0,
"title": "Cost Ratio",
"type": "number"
},
"regime": {
"default": "forfettario_15",
"title": "Regime",
"type": "string"
},
"revenue_eur": {
"title": "Revenue Eur",
"type": "number"
}
},
"required": [
"revenue_eur"
],
"title": "calculate_italian_taxArguments",
"type": "object"
},
"name": "calculate_italian_tax",
"outputSchema": {
"$defs": {
"Breakdown": {
"properties": {
"assumptions": {
"default": [],
"items": {
"type": "string"
},
"title": "Assumptions",
"type": "array"
},
"contributions_are_stand_in": {
"default": false,
"title": "Contributions Are Stand In",
"type": "boolean"
},
"country": {
"title": "Country",
"type": "string"
},
"currency": {
"enum": [
"EUR",
"PLN",
"RON"
],
"title": "Currency",
"type": "string"
},
"effective_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Effective Rate"
},
"eligible": {
"default": true,
"title": "Eligible",
"type": "boolean"
},
"health_contribution": {
"default": 0,
"title": "Health Contribution",
"type": "number"
},
"income_tax": {
"default": 0,
"title": "Income Tax",
"type": "number"
},
"net_eur": {
"default": 0,
"title": "Net Eur",
"type": "number"
},
"net_local": {
"default": 0,
"title": "Net Local",
"type": "number"
},
"notes": {
"default": [],
"items": {
"type": "string"
},
"title": "Notes",
"type": "array"
},
"other_deductions": {
"default": 0,
"title": "Other Deductions",
"type": "number"
},
"regime": {
"title": "Regime",
"type": "string"
},
"revenue_eur": {
"title": "Revenue Eur",
"type": "number"
},
"revenue_local": {
"title": "Revenue Local",
"type": "number"
},
"social_contributions": {
"default": 0,
"title": "Social Contributions",
"type": "number"
},
"substitute_tax": {
"default": 0,
"title": "Substitute Tax",
"type": "number"
}
},
"required": [
"country",
"regime",
"revenue_local",
"revenue_eur",
"currency"
],
"title": "Breakdown",
"type": "object"
}
},
"description": "A single deterministic tax calculation.",
"properties": {
"breakdown": {
"$ref": "#/$defs/Breakdown",
"description": "Full numeric breakdown (taxes, contributions, net, effective rate)."
},
"disclaimer": {
"title": "Disclaimer",
"type": "string"
}
},
"required": [
"breakdown",
"disclaimer"
],
"title": "CalcResult",
"type": "object"
}
},
{
"description": "Compare all Italian regimes side by side at one revenue level.\n\n Runs forfettario (5% & 15%), ordinario, and ordinario + impatriati through\n the deterministic engine and returns them sorted by net income (best first),\n each with its full breakdown and eligibility.\n\n Args:\n revenue_eur: Gross annual revenue in EUR.\n coefficient: Forfettario coefficiente di redditività (0.40–0.86); omit\n for the professional-services default (0.78).\n cost_ratio: Deductible costs as a fraction of revenue (0–1) for the\n ordinario regimes.\n ",
"inputSchema": {
"properties": {
"coefficient": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Coefficient"
},
"cost_ratio": {
"default": 0,
"title": "Cost Ratio",
"type": "number"
},
"revenue_eur": {
"title": "Revenue Eur",
"type": "number"
}
},
"required": [
"revenue_eur"
],
"title": "compare_italian_regimesArguments",
"type": "object"
},
"name": "compare_italian_regimes",
"outputSchema": {
"$defs": {
"Breakdown": {
"properties": {
"assumptions": {
"default": [],
"items": {
"type": "string"
},
"title": "Assumptions",
"type": "array"
},
"contributions_are_stand_in": {
"default": false,
"title": "Contributions Are Stand In",
"type": "boolean"
},
"country": {
"title": "Country",
"type": "string"
},
"currency": {
"enum": [
"EUR",
"PLN",
"RON"
],
"title": "Currency",
"type": "string"
},
"effective_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Effective Rate"
},
"eligible": {
"default": true,
"title": "Eligible",
"type": "boolean"
},
"health_contribution": {
"default": 0,
"title": "Health Contribution",
"type": "number"
},
"income_tax": {
"default": 0,
"title": "Income Tax",
"type": "number"
},
"net_eur": {
"default": 0,
"title": "Net Eur",
"type": "number"
},
"net_local": {
"default": 0,
"title": "Net Local",
"type": "number"
},
"notes": {
"default": [],
"items": {
"type": "string"
},
"title": "Notes",
"type": "array"
},
"other_deductions": {
"default": 0,
"title": "Other Deductions",
"type": "number"
},
"regime": {
"title": "Regime",
"type": "string"
},
"revenue_eur": {
"title": "Revenue Eur",
"type": "number"
},
"revenue_local": {
"title": "Revenue Local",
"type": "number"
},
"social_contributions": {
"default": 0,
"title": "Social Contributions",
"type": "number"
},
"substitute_tax": {
"default": 0,
"title": "Substitute Tax",
"type": "number"
}
},
"required": [
"country",
"regime",
"revenue_local",
"revenue_eur",
"currency"
],
"title": "Breakdown",
"type": "object"
}
},
"description": "Deterministic side-by-side of the Italian regimes at one revenue level.",
"properties": {
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"results": {
"description": "One breakdown per regime, best net income first.",
"items": {
"$ref": "#/$defs/Breakdown"
},
"title": "Results",
"type": "array"
},
"revenue_eur": {
"description": "Gross annual revenue (EUR) the regimes were evaluated at.",
"title": "Revenue Eur",
"type": "number"
}
},
"required": [
"revenue_eur",
"results",
"disclaimer"
],
"title": "RegimeComparison",
"type": "object"
}
},
{
"description": "List the primary sources the corpus can search, and what each covers.\n\n Use this to discover the valid `sources` filter values for\n `search_italian_tax_sources` and to understand the corpus's coverage.\n ",
"inputSchema": {
"properties": {},
"title": "list_tax_sourcesArguments",
"type": "object"
},
"name": "list_tax_sources",
"outputSchema": {
"$defs": {
"TaxSourceInfo": {
"description": "A retrievable source and what it covers.",
"properties": {
"description": {
"description": "What this source covers / when to use it.",
"title": "Description",
"type": "string"
},
"key": {
"description": "Filter value for `search_italian_tax_sources`.",
"title": "Key",
"type": "string"
},
"label": {
"description": "Human-readable source name.",
"title": "Label",
"type": "string"
}
},
"required": [
"key",
"label",
"description"
],
"title": "TaxSourceInfo",
"type": "object"
}
},
"description": "The set of primary sources the corpus can search.",
"properties": {
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"sources": {
"items": {
"$ref": "#/$defs/TaxSourceInfo"
},
"title": "Sources",
"type": "array"
}
},
"required": [
"sources",
"disclaimer"
],
"title": "SourcesCatalogue",
"type": "object"
}
},
{
"description": "Search TaxCompass's primary-source corpus and return passages to cite.\n\n Hybrid semantic + keyword retrieval over Italian tax & company-law primary\n sources: Normattiva (statute), Agenzia delle Entrate (circolari & guidance),\n INPS (social security), pinned tax-year tables (IRPEF brackets, INPS rates,\n forfettario thresholds & coefficienti di redditività), the ATECO 2025 code\n catalogue, and EU/treaty sources.\n\n Each result carries a `chunk_id`, `source`, and (usually) a `url`. Cite the\n `url` and quote the `text`; do not assert Italian tax facts the passages\n don't support. Queries work in any language, but Italian keywords improve\n recall against the (Italian) legal corpus.\n\n Args:\n query: What to search for. Keyword-dense Italian phrasing works best.\n sources: Optional subset to restrict to (see `list_tax_sources` for keys).\n Omit to search everything. Unknown keys are ignored.\n k: Max passages to return (1–12).\n ",
"inputSchema": {
"properties": {
"k": {
"default": 6,
"title": "K",
"type": "integer"
},
"query": {
"title": "Query",
"type": "string"
},
"sources": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Sources"
}
},
"required": [
"query"
],
"title": "search_italian_tax_sourcesArguments",
"type": "object"
},
"name": "search_italian_tax_sources",
"outputSchema": {
"$defs": {
"SourcePassage": {
"description": "One retrieved passage from a primary source, with everything needed to cite it.",
"properties": {
"chunk_id": {
"description": "Stable citation id for this passage (cite this).",
"title": "Chunk Id",
"type": "string"
},
"similarity": {
"description": "Hybrid relevance score in ~[0,1]; higher is closer.",
"title": "Similarity",
"type": "number"
},
"source": {
"description": "Source key, e.g. 'normattiva', 'ade', 'inps', 'tables', 'ateco'.",
"title": "Source",
"type": "string"
},
"source_label": {
"description": "Human-readable source name.",
"title": "Source Label",
"type": "string"
},
"text": {
"description": "The passage text. Quote/paraphrase only what this supports.",
"title": "Text",
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Document/section title, if known.",
"title": "Title"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link to the primary source — cite this URL.",
"title": "Url"
}
},
"required": [
"chunk_id",
"source",
"source_label",
"text",
"similarity"
],
"title": "SourcePassage",
"type": "object"
}
},
"description": "Result of a primary-source search.",
"properties": {
"count": {
"description": "Number of passages returned.",
"title": "Count",
"type": "integer"
},
"disclaimer": {
"description": "Usage + citation guidance.",
"title": "Disclaimer",
"type": "string"
},
"passages": {
"description": "Retrieved passages, most relevant first.",
"items": {
"$ref": "#/$defs/SourcePassage"
},
"title": "Passages",
"type": "array"
},
"query": {
"description": "The query that was run.",
"title": "Query",
"type": "string"
},
"sources_searched": {
"description": "Source keys actually searched (after filtering).",
"items": {
"type": "string"
},
"title": "Sources Searched",
"type": "array"
}
},
"required": [
"query",
"sources_searched",
"count",
"passages",
"disclaimer"
],
"title": "SearchResponse",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:206a634ef38b927b725755898ee9e0a78d52e38855d7205d282db1e452148b5b | sha256sum