This MCP server provides French individual income tax calculations for AI assistants. It can compute net tax due based on net taxable income, household composition (quotient familial), and year. It also exposes a tool to retrieve the current French income tax brackets from official sources, with dynamic data fetched via web scraping from government sites and a fallback to hardcoded data if scraping fails. Tools are exposed under the MCP as calculate_income_tax and get_tax_brackets. You can call calculate_income_tax by supplying net_taxable_income, household_parts (defaults to 1.0), and an optional year. get_tax_brackets returns the current brackets for a specified year or defaults to the current year. Typical usage involves asking the MCP to compute your tax for a given income and family situation, or to fetch the latest bracket thresholds to review how tax bands are structured.

Prerequisites:\n- Python 3.10+ (recommended)\n- pip (Python package installer) available in your environment\n- Optional: uv (for development) or install via pip as shown\n\nInstall from PyPI (stable release):\n pip install french-tax-mcp ``\n\nOr install via uv for a lightweight, recommended runtime:\n uv pip install french-tax-mcp ``\n\nRun the server locally (examples shown use the package entry point):\n```

If installed as a package, you may run the server module directly

python -m french_tax_mcp.server --port 8888 ``\n\nDevelopment workflow (from source):\n```

Clone the repository

git clone https://github.com/your-username/french-tax-mcp.git cd french-tax-mcp

Install in development mode with dev dependencies

pip install -e ".[dev]"

Run the server locally

python -m french_tax_mcp.server --port 8888

Tips and reminders:\n- The server uses web scraping (via MarkItDown) to fetch current French tax information, with a fallback to hardcoded data if scraping fails. This means results may vary if government sites change structure.\n- Environment variable FASTMCP_LOG_LEVEL can be set to INFO or DEBUG for more verbose logs during troubleshooting.\n- The MCP config example uses uvx to install the package at latest and run the server; other environments (npx, node) are not needed for this Python-based server.\n- Currently, calculations are for informational purposes and should be verified against official tax guidance for critical decisions.\n- If you update data sources or logic, consider adding regression tests under tests/ to guard against changes in tax rules or scraping behavior.