{
  "name": "ai2fin-tax",
  "title": "2Fin Tax MCP",
  "greeting": "🐬 You found Fin's Tax MCP — the tax brain your agent calls. Every answer is source-cited to the national tax authority with a verified date.",
  "version": "0.4.0",
  "protocol": "MCP (JSON-RPC 2.0 over HTTP) — POST your messages to this URL.",
  "scope": "Public tax rates & calculators only — no login, no account data, nothing stored.",
  "accountServer": "For your own 2Fin data (transactions, live tax position), use the authenticated app MCP at https://api.ai2fin.com/mcp",
  "countries": 50,
  "tools": [
    {
      "name": "tax_rate_lookup",
      "description": "Look up one country's headline tax rates: GST/VAT standard and reduced rates, top personal income tax rate, and company tax rate. Use it for a single country; to see several countries side by side use compare_countries, and to apply GST/VAT to an amount use compute_gst_vat. Rates come from a fixed dataset verified against the national tax authority — every answer names its source and verification date, and an unsupported country returns a clear error rather than a guess."
    },
    {
      "name": "compute_gst_vat",
      "description": "Add or remove a country's GST/VAT on a monetary amount, returning the net / tax / gross split. Use it to convert between tax-exclusive and tax-inclusive prices (invoices, quotes, receipts); for the rates themselves use tax_rate_lookup. Pure arithmetic on the country's current standard rate, rounded to 2 decimals, in the country's local currency. Countries without a single national GST/VAT (e.g. the US) return an explanatory error instead of a wrong number."
    },
    {
      "name": "compare_countries",
      "description": "Compare headline tax rates — GST/VAT, top personal income tax and company tax — across several countries at once. Use it to shortlist or contrast jurisdictions (relocation, expansion, pricing); for one country's full detail use tax_rate_lookup, and to apply a rate to an amount use compute_gst_vat. Codes the dataset does not cover are reported back in unmatchedCodes rather than silently dropped; every matched row cites its national tax authority."
    },
    {
      "name": "income_tax_estimate",
      "description": "Estimate personal income tax and take-home pay for Australia or New Zealand from gross annual income, using effective-dated brackets that roll over automatically each financial year (AU includes the Medicare levy and Low Income Tax Offset). Use it for individual salary and take-home questions in AU or NZ only — other countries return 'not available' rather than a guess; their headline rates live in tax_rate_lookup. This is a resident-individual estimate, not a filing calculation: deductions and offsets beyond LITO are out of scope, and for compulsory HELP/HECS study-loan repayments use student_loan_repayment."
    },
    {
      "name": "company_tax_estimate",
      "description": "Estimate company/corporate income tax on an annual profit for Australia, the US, the UK, India or Canada — the five countries with source-verified company rates — applying the small-business/concessional rate where it covers all income. Use it for company profit questions in those countries; individuals belong to income_tax_estimate, and any other country’s headline rate to tax_rate_lookup. Headline-rate arithmetic only: US state tax, Canadian provincial tax, Indian surcharge/cess and UK marginal relief are flagged in the response note but not computed. A negative profit returns an explanation (losses carry forward), never a negative tax."
    },
    {
      "name": "cgt_estimate",
      "description": "Estimate Australian capital gains tax for a resident individual by taxing the gain at the marginal rate on top of other income (the difference of two income-tax calculations). Use it for AU asset-sale questions (shares, property, crypto); for pay without an asset sale use income_tax_estimate — other countries' CGT is not covered and returns an error. Applies capital losses before the 50% discount for assets held over 12 months, per ATO ordering; the main-residence exemption and non-resident rules are out of scope."
    },
    {
      "name": "student_loan_repayment",
      "description": "Estimate the compulsory annual study or training loan repayment (HELP, HECS, VSL, SFSS, SSL, AASL) for an Australian resident from their repayment income, using the marginal system introduced in 2025-26 with effective-dated thresholds that roll over each financial year. Use it for \"how much HELP/HECS will I repay\" questions in AU; it does not cover the loan balance, indexation or voluntary repayments, and applies to Australia only. Repayment income is broader than taxable income — it adds back reportable super contributions, reportable fringe benefits, net investment loss and exempt foreign income; pass that combined figure."
    },
    {
      "name": "superannuation_estimate",
      "description": "Estimate Australian superannuation for an employee: the compulsory Superannuation Guarantee contribution (12% from 2025-26), concessional (before-tax) contributions cap usage, the 15% in-fund contributions tax, and the Division 293 high-earner surcharge — all effective-dated so a future budget year is picked automatically. Use it for \"how much super will I get / can I contribute / will I be taxed\" questions in AU; it does not model fund fees, insurance, investment returns, non-concessional contributions or carry-forward caps, and applies to Australia only. Salary sacrifice and personal deductible contributions add to the concessional total; other taxable income is only needed to test the Division 293 threshold."
    }
  ],
  "quickstart": {
    "connect": "Add https://taxmcp.ai2fin.com as a custom MCP connector in Claude (Settings → Connectors), ChatGPT, Cursor, or your own agent.",
    "example": {
      "method": "tools/call",
      "params": {
        "name": "compute_gst_vat",
        "arguments": {
          "country": "AU",
          "amount": 100
        }
      }
    },
    "curl": "curl -s https://taxmcp.ai2fin.com -X POST -H 'content-type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"compute_gst_vat\",\"arguments\":{\"country\":\"AU\",\"amount\":100}}}'"
  },
  "web": "https://ai2fin.com/tools/taxmcp",
  "note": "Computed from published government rates — general information to plan with, not personal tax or financial advice. For decisions about your own situation, check with the authority or a registered adviser."
}