Repository avatar
Other Tools
v0.6.0
active

ai2fin-tax-mcp

com.ai2fin/ai2fin-tax-mcp

Free, cited tax MCP: GST/VAT for 193 countries, US/CA sales tax, income tax 57, company 139, CGT 71.

Documentation

2Fin

2Fin Tax MCP

Free, no-auth tax tools for AI assistants: GST/VAT, income, company and capital-gains tax, in every country we have verified data for, each answer cited to the national tax authority.

  • Endpoint: https://taxmcp.ai2fin.com (streamable HTTP, JSON-RPC, no API key, stateless)
  • Clients: Claude, ChatGPT (developer mode), Cursor, VS Code, or any MCP client
  • Source of truth: the same tax engine behind the calculators at ai2fin.com/tools

Every result carries its source authority and a "general information, not tax advice" note. Where data isn't verified for a country, the tool says so instead of guessing.

Tools

ToolTitleWhat it does
tax_rate_as_ofHistorical tax rate lookupThe GST/VAT standard rate that applied in a country on a given date.
tax_rate_lookupCountry tax rate lookupHeadline GST/VAT, top income tax and company tax rates for 193 countries, plus CA and US state/provincial sales tax.
compute_gst_vatGST/VAT add or remove calculatorAdd or remove a country's GST/VAT (or other national consumption tax) on an amount: net, tax and gross.
compare_countriesMulti-country tax comparisonGST/VAT, top income tax and company tax side by side across several countries.
income_tax_estimateIncome tax & take-home estimateIncome tax and take-home pay for 57 countries over effective-dated brackets, with each country's levies and offsets.
company_tax_estimateCompany tax estimateCompany tax on an annual profit for 139 countries, marking which are verified against the national authority.
cgt_estimateCapital gains tax estimateCapital gains tax on one sale of shares or property by a resident individual, for 71 countries.
student_loan_repaymentAustralian HELP/HECS repaymentThe compulsory annual study-loan repayment from repayment income, effective-dated by financial year.
superannuation_estimateAustralian superannuation estimateSuperannuation Guarantee, concessional cap usage, contributions tax and Division 293.
tax_factsSourced tax factsWhen and why a country's GST/VAT began and other true, sourced stories about its tax system.

All tools are read-only and idempotent, and each declares an output schema.

Connect

Remote (recommended). Add https://taxmcp.ai2fin.com as a custom connector:

  • Claude: Settings → Connectors → Add custom connector
  • ChatGPT: Settings → Apps & Connectors → developer mode → Create
  • Cursor / VS Code / others:
{
  "mcpServers": {
    "2fin-tax": { "url": "https://taxmcp.ai2fin.com" }
  }
}

stdio. For clients that only run local servers, this repo's connector relays stdio to the hosted endpoint (Node 18+, no dependencies):

{
  "mcpServers": {
    "2fin-tax": { "command": "npx", "args": ["-y", "github:ai2finlive/ai2fin-tax-mcp"] }
  }
}

or with Docker:

docker build -t 2fin-tax-mcp . && docker run -i --rm 2fin-tax-mcp

Quick check

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,"mode":"add"}}}'

What's in this repo

The hosted server does the computing. This repo is the public home of the listing and a small stdio connector (bin/stdio-proxy.mjs) that forwards JSON-RPC to the endpoint. It contains no tax logic or data. Set TAX_MCP_URL to point it at another deployment.

npm test   # connector tests (local stand-in endpoint, no network)

Privacy

The endpoint is stateless: it computes over public rate data and stores nothing you send. It is separate from the authenticated 2Fin app MCP at app.ai2fin.com/mcp, which works on your own financial data behind OAuth.

License

MIT for the code in this repo. See LICENSE.

No installation packages available.

Remote