# French Tax MCP Server
[](https://opensource.org/licenses/Apache-2.0)
[](https://www.python.org/downloads/)
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
```bash
# 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`):
```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
```bash
# 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
```bash
# 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](LICENSE) file for details.
## Links
- **Official French Tax Website**: https://www.impots.gouv.fr
- **MCP Protocol**: https://modelcontextprotocol.io/
Raw data
{
"_id": null,
"home_page": null,
"name": "french-tax-mcp",
"maintainer": "Corneliu CROITORU",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ai-assistant, france, french-tax, impots, mcp, model-context-protocol, tax-calculation, tax-scraper",
"author": "Corneliu CROITORU",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b0/eb/6b9325906a81967acd942a24103da246629c337cc56a7545ce7daf9ceedd/french_tax_mcp-1.1.0.tar.gz",
"platform": null,
"description": "# French Tax MCP Server\n\n[](https://opensource.org/licenses/Apache-2.0)\n[](https://www.python.org/downloads/)\n\nAn MCP (Model Context Protocol) server that provides French individual income tax calculations to AI assistants.\n\n## Current Functionality\n\nThis MCP server currently supports:\n\n- **Individual Income Tax Calculations**: Calculate French income tax (imp\u00f4t sur le revenu) based on net taxable income and household composition (quotient familial)\n- **Tax Brackets**: Retrieve current French income tax brackets from official government sources\n- **Dynamic Data**: Uses web scraping from service-public.fr to get up-to-date tax information with fallback to hardcoded data\n\n## Data Sources\n\nThe 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.\n\n## Installation\n\n```bash\n# Install via pip\npip install french-tax-mcp\n\n# Or install via uv (recommended)\nuv pip install french-tax-mcp\n```\n\n## MCP Configuration\n\nAdd to your MCP configuration file (`~/.config/mcp/mcp.json` or workspace `.kiro/settings/mcp.json`):\n\n```json\n{\n \"mcpServers\": {\n \"french-tax-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"french-tax-mcp@latest\"],\n \"env\": {\n \"FASTMCP_LOG_LEVEL\": \"ERROR\"\n },\n \"disabled\": false,\n \"autoApprove\": []\n }\n }\n}\n```\n\n## Available Tools\n\n### `calculate_income_tax`\nCalculate French individual income tax.\n\n**Parameters:**\n- `net_taxable_income`: Net taxable income in euros\n- `household_parts`: Number of household parts (quotient familial) - defaults to 1.0\n- `year`: Tax year (optional, defaults to current year)\n\n**Example:**\n```\nCalculate income tax for 50,000\u20ac salary with 2 children\n```\n\n### `get_tax_brackets`\nRetrieve current French income tax brackets.\n\n**Parameters:**\n- `year`: Tax year (optional, defaults to current year)\n\n**Example:**\n```\nWhat are the current French tax brackets?\n```\n\n## Usage Examples\n\n**Basic calculation:**\n```\nHow much income tax will I pay on 45,000\u20ac salary?\n```\n\n**Family situation:**\n```\nCalculate tax for married couple earning 60,000\u20ac with one child\n```\n\n**Tax brackets:**\n```\nShow me the 2024 French tax brackets\n```\n\n## Limitations\n\n- Currently supports only individual income tax calculations for French residents\n- Web scraping may occasionally fail (fallback data is used in such cases)\n- Tax calculations are for informational purposes only\n\n## TODO - Future Features\n\nThe following features may be added in future versions:\n\n- [ ] **LMNP (Location Meubl\u00e9e Non Professionnelle)** - Furnished rental tax calculations\n- [ ] **Pinel Investment** - Real estate investment tax benefits\n- [ ] **Micro-Enterprise/Auto-Entrepreneur** - Business tax calculations\n- [ ] **Corporate Tax** - Company tax calculations\n- [ ] **Property Tax** - Real estate tax information\n- [ ] **Social Charges** - Social security contributions\n- [ ] **Tax Forms** - Detailed form guidance and filling assistance\n- [ ] **Official API Integration** - Replace web scraping with official government APIs\n\n## Development\n\n### Local Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-username/french-tax-mcp.git\ncd french-tax-mcp\n\n# Install in development mode\npip install -e \".[dev]\"\n\n# Run the server locally\npython -m french_tax_mcp.server --port 8888\n```\n\n### Running Tests\n\n```bash\n# Run tests\npython -m pytest tests/\n```\n\n## Legal Notice\n\nThis 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.\n\nTax 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.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## Links\n\n- **Official French Tax Website**: https://www.impots.gouv.fr\n- **MCP Protocol**: https://modelcontextprotocol.io/\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "MCP server for French tax calculations and information",
"version": "1.1.0",
"project_urls": {
"Changelog": "https://github.com/cornelcroi/french-tax-mcp/releases",
"Documentation": "https://github.com/cornelcroi/french-tax-mcp#readme",
"Homepage": "https://github.com/cornelcroi/french-tax-mcp",
"Issues": "https://github.com/cornelcroi/french-tax-mcp/issues",
"Repository": "https://github.com/cornelcroi/french-tax-mcp.git"
},
"split_keywords": [
"ai-assistant",
" france",
" french-tax",
" impots",
" mcp",
" model-context-protocol",
" tax-calculation",
" tax-scraper"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0203bbda6663dc883573fd92ad77449f8d88c93ea9c7692b8338f6b93350ca20",
"md5": "e8a7b570729808a7ae38554bd03b9684",
"sha256": "9e224c61c1c95e0aea81512c7d5f1fadfae6ae4a824e674feab5c2c5bff37a56"
},
"downloads": -1,
"filename": "french_tax_mcp-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e8a7b570729808a7ae38554bd03b9684",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 41084,
"upload_time": "2025-09-08T17:18:00",
"upload_time_iso_8601": "2025-09-08T17:18:00.688558Z",
"url": "https://files.pythonhosted.org/packages/02/03/bbda6663dc883573fd92ad77449f8d88c93ea9c7692b8338f6b93350ca20/french_tax_mcp-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b0eb6b9325906a81967acd942a24103da246629c337cc56a7545ce7daf9ceedd",
"md5": "df7521abaf6baa1b889276e9f43c0341",
"sha256": "874524db522092c5a6f904472e2dc1f20b85148b076410e97c0c3f0a9f828bc4"
},
"downloads": -1,
"filename": "french_tax_mcp-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "df7521abaf6baa1b889276e9f43c0341",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 30910,
"upload_time": "2025-09-08T17:18:01",
"upload_time_iso_8601": "2025-09-08T17:18:01.804732Z",
"url": "https://files.pythonhosted.org/packages/b0/eb/6b9325906a81967acd942a24103da246629c337cc56a7545ce7daf9ceedd/french_tax_mcp-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-08 17:18:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cornelcroi",
"github_project": "french-tax-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "french-tax-mcp"
}
JSON
