French Tax MCP Server

Instructions

Implementation Reference

• french_tax_mcp/server.py:83-130 (handler)

  Primary handler for the 'get_tax_info_from_web' tool. Registers the tool with MCP and implements the core logic: determines the scraper based on tax_topic (currently only supports tax brackets), lazily imports and calls helper functions, handles defaults and errors.
  @mcp.tool( name="get_tax_info_from_web", description="Get tax information from official French government websites like impots.gouv.fr, service-public.fr, or legifrance.gouv.fr", ) async def get_tax_info_from_web(tax_topic: str, ctx: Context, year: Optional[int] = None) -> Optional[Dict]: """Get tax information from official French government websites. Args: tax_topic: The tax topic to search for (e.g., 'tranches_impot', 'pinel', 'lmnp') year: Optional tax year (defaults to current year if not specified) ctx: MCP context for logging and state management Returns: Dict: Dictionary containing the tax information retrieved from the website """ try: # This is a placeholder implementation # The actual implementation will be more complex and will use specialized scrapers # Set default year to current year if not specified if year is None: year = datetime.now().year await ctx.info(f"Retrieving information about {tax_topic} for year {year}") # Map topic to appropriate scraper if tax_topic.lower() in ["tranches_impot", "baremes", "tax_brackets"]: # Use tax brackets scraper (lazy import) from french_tax_mcp.scrapers.impots_scraper import get_tax_brackets result = await get_tax_brackets(year) return result else: # Generic response for now return { "status": "error", "message": f"Information for {tax_topic} not yet implemented", "year": year, } except Exception as e: await ctx.error(f"Failed to get tax information from web: {e}") return { "status": "error", "message": f"Error retrieving information: {str(e)}", "topic": tax_topic, "year": year, }
• french_tax_mcp/server.py:76-81 (schema)

  Pydantic BaseModel defining the input schema for tax information requests, matching the tool's parameters (tax_topic -> topic, year).
  class TaxInfoRequest(BaseModel): """Request model for tax information queries.""" topic: str = Field(..., description="The tax topic to search for (e.g., 'tranches_impot', 'pinel', 'lmnp')") year: Optional[int] = Field(None, description="Tax year (defaults to current year if not specified)")
• french_tax_mcp/scrapers/impots_scraper.py:473-512 (helper)

  Supporting helper function 'get_tax_brackets' called by the main handler for tax bracket topics. Scrapes using MarkItDown from service-public.fr, parses brackets from markdown, with fallback to hardcoded data.
  async def get_tax_brackets(year: Optional[int] = None) -> Dict: """Get income tax brackets using MarkItDown scraper with fallback to hardcoded data. Args: year: Tax year (defaults to current year) Returns: Dictionary containing the tax brackets and rates """ try: # Try MarkItDown scraper first (more reliable) from markitdown import MarkItDown md = MarkItDown() url = "https://www.service-public.fr/particuliers/vosdroits/F1419" logger.info(f"Fetching tax brackets using MarkItDown from {url}") result = md.convert_url(url) brackets = _parse_brackets_from_markdown(result.text_content) if brackets: current_year = year or datetime.now().year logger.info(f"Successfully parsed {len(brackets)} tax brackets using MarkItDown") return { "status": "success", "data": { "year": current_year, "brackets": brackets }, "source": "service-public.fr (MarkItDown)" } # Fallback to hardcoded data logger.warning("MarkItDown parsing failed, using hardcoded tax brackets") return _get_fallback_tax_brackets(year) except Exception as e: logger.error(f"MarkItDown scraping failed: {e}") return _get_fallback_tax_brackets(year)