French Tax MCP

🚀 French Tax MCP Server

This MCP (Model Context Protocol) server offers French individual income tax calculations to AI assistants, leveraging reliable data sources for accurate results.

🚀 Quick Start

This MCP server currently offers a range of functions related to French individual income tax calculations. It can calculate income tax based on net taxable income and household composition, retrieve current tax brackets, and uses web - scraping to obtain up - to - date tax information.

✨ Features

• 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.

📦 Installation

# Install via pip
pip install french - tax - mcp

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

📚 Documentation

MCP Configuration

Add the following 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 Usage

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

Advanced Usage

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

Show me the 2024 French tax brackets

🔧 Technical Details

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.

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 LICENSE file for details.

Links

• Official French Tax Website: https://www.impots.gouv.fr
• MCP Protocol: https://modelcontextprotocol.io/