French Tax

This MCP server provides up-to-date French individual income tax calculations and current tax brackets for AI assistants. It enables you to compute impôt sur le revenu based on net taxable income and family composition, and to retrieve the latest brackets used by France's tax system.

How to use

You interact with this server through an MCP client. Use the available tools to calculate tax or fetch current tax brackets. The server relies on dynamic data, but it includes fallback data if live sources are temporarily unavailable.

Available tools let you perform two main actions: calculate the income tax for a given net taxable income and household composition, and retrieve the current tax brackets for a specific year. You can supply optional year information to target a particular tax year.

How to install

Prerequisites you need before installation:

Python should be installed on your system. You can verify by running python --version.

Install the MCP package using the recommended runtime:

pip install french-tax-mcp

Or use the recommended runtime with the package:

uv pip install french-tax-mcp

Configure the MCP client to run this server. You will add a server entry that uses the runtime and points to the latest package version. The configuration snippet below shows how to enable the French Tax MCP server in your MCP setup:

{
  "mcpServers": {
    "french_tax_mcp": {
      "command": "uvx",
      "args": ["french-tax-mcp@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Additional sections

Configuration details and usage tips are provided here to help you operate the French Tax MCP server smoothly. The server can fetch current tax information from official sources and uses a fallback when live data is temporarily unavailable.

Security note: Only expose the MCP endpoint to trusted clients, as the server handles tax calculations and potentially sensitive inputs such as household composition. You can adjust logging with the environment variable FASTMCP_LOG_LEVEL when configuring the server.

Examples of common usage scenarios include:

• Basic calculation for a given net taxable income and household parts
• Requesting current tax brackets for a specific year

Data sources: The server gathers tax information dynamically from official French government sources, with a fallback to hardcoded data if live sources are not reachable.

Tools and endpoints

calculate_income_tax
Parameters:
- net_taxable_income: Net taxable income in euros
- household_parts: Number of household parts (quotient familial) - defaults to 1.0
- year: Tax year (optional, defaults to current year)

Example:
Calculate income tax for 50,000€ salary with 2 children

Examples of usage

How much income tax will I pay on 45,000€ salary?

Limitations

• This server currently supports only individual income tax calculations for French residents.
• Web scraping may occasionally fail, in which case a fallback dataset is used.
• Tax calculations are for informational purposes only.

Notes on future features

Planned enhancements may include more tax scenarios (real estate and business taxes), forms guidance, and potential API integrations for official data sources.

Available tools

calculate_income_tax

Calculate French individual income tax based on net taxable income, household parts, and optional tax year.

get_tax_brackets

Retrieve current French income tax brackets for a given year.