french-tax-mcp by cornelcroi - MCP Server

French Tax MCP Server

An MCP (Model Context Protocol) server that provides French individual income tax calculations to AI assistants.

Current Functionality

This MCP server currently supports:

Individual Income Tax Calculations: Calculate French income tax (impôt sur le revenu) based on net taxable income and household composition (quotient familial)
Tax Brackets: Retrieve current French income tax brackets from official government sources
Dynamic Data: Uses web scraping from service-public.fr to get up-to-date tax information with fallback to hardcoded data

Data Sources

The current version uses web scraping with MarkItDown to fetch tax information from official French government websites (primarily service-public.fr). In future versions, this may be replaced with official APIs or other more reliable data sources when available.

Installation

# Install via pip
pip install french-tax-mcp

# Or install via uv (recommended)
uv pip install french-tax-mcp

MCP Configuration

Add to your MCP configuration file (~/.config/mcp/mcp.json or workspace .kiro/settings/mcp.json):

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

Available Tools

`calculate_income_tax`

Calculate French individual 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

`get_tax_brackets`

Retrieve current French income tax brackets.

Parameters:

year: Tax year (optional, defaults to current year)

Example:

What are the current French tax brackets?

Usage Examples

Basic calculation:

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

Family situation:

Calculate tax for married couple earning 60,000€ with one child

Tax brackets:

Show me the 2024 French tax brackets

Limitations

Currently supports only individual income tax calculations for French residents
Web scraping may occasionally fail (fallback data is used in such cases)
Tax calculations are for informational purposes only

TODO - Future Features

The following features may be added in future versions:

LMNP (Location Meublée Non Professionnelle) - Furnished rental tax calculations
Pinel Investment - Real estate investment tax benefits
Micro-Enterprise/Auto-Entrepreneur - Business tax calculations
Corporate Tax - Company tax calculations
Property Tax - Real estate tax information
Social Charges - Social security contributions
Tax Forms - Detailed form guidance and filling assistance
Official API Integration - Replace web scraping with official government APIs

Development

Local Development

# Clone the repository
git clone https://github.com/your-username/french-tax-mcp.git
cd french-tax-mcp

# Install in development mode
pip install -e ".[dev]"

# Run the server locally
python -m french_tax_mcp.server --port 8888

Running Tests

# Run tests
python -m pytest tests/

Legal Notice

This tool provides information for informational purposes only and does not constitute professional tax advice. For advice tailored to your personal situation, please consult a certified public accountant or tax advisor.

Tax information is sourced from official French government websites but may not reflect the most recent changes in tax laws. Always verify calculations with official sources.

License

This project is licensed under the Apache License 2.0 - see the file for details.

cornelcroi/french-tax-mcp