French Tax MCP Server

Instructions

Implementation Reference

• french_tax_mcp/server.py:436-439 (registration)

  MCP tool registration decorator for 'get_tax_deadlines'.

  @mcp.tool(
      name="get_tax_deadlines",
      description="Get tax deadlines from service-public.fr",
  )

• french_tax_mcp/server.py:440-467 (handler)

  The MCP tool handler wrapper that delegates to the service_public_scraper.get_tax_deadlines function.

  async def get_tax_deadlines_wrapper(
      year: Optional[int] = None,
      ctx: Optional[Context] = None,
  ) -> Optional[Dict]:
      """Get tax deadlines from service-public.fr.
  
      Args:
          year: The tax year to retrieve deadlines for (defaults to current year)
          ctx: MCP context for logging
  
      Returns:
          Dict: Dictionary containing tax deadlines
      """
      try:
          if ctx:
              await ctx.info(f"Getting tax deadlines for year {year or 'current'}")
  
          from french_tax_mcp.scrapers.service_public_scraper import get_tax_deadlines
          result = await get_tax_deadlines(year)
          return result
      except Exception as e:
          if ctx:
              await ctx.error(f"Failed to get tax deadlines: {e}")
          return {
              "status": "error",
              "message": f"Error getting tax deadlines: {str(e)}",
          }

• french_tax_mcp/scrapers/service_public_scraper.py:284-327 (helper)

  Core scraping logic for tax deadlines in ServicePublicScraper class method.

  async def get_tax_deadlines(self, year: Optional[int] = None) -> Dict:
      """Scrape tax deadlines from service-public.fr.
  
      Args:
          year: The tax year to retrieve deadlines for. Defaults to current year.
  
      Returns:
          Dictionary containing tax deadlines
      """
      # Set default year to current year if not specified
      current_year = datetime.now().year
      tax_year = year or current_year
  
      logger.info(f"Scraping tax deadlines for year {tax_year}")
  
      try:
          # Get the page
          response = await self.get_page(DEADLINES_URL)
  
          # Parse HTML
          soup = self.parse_html(response.text)
  
          # Extract deadlines
          deadlines = self._extract_deadlines(soup, tax_year)
  
          return self.format_result(
              status="success",
              data={
                  "year": tax_year,
                  "deadlines": deadlines,
              },
              message=f"Successfully retrieved tax deadlines for {tax_year}",
              source_url=f"{BASE_URL}{DEADLINES_URL}",
          )
  
      except Exception as e:
          logger.error(f"Error scraping tax deadlines: {e}")
          return self.format_result(
              status="error",
              message=f"Failed to retrieve tax deadlines: {str(e)}",
              data={"year": tax_year},
              error=e,
          )

• french_tax_mcp/scrapers/service_public_scraper.py:438-447 (helper)

  Standalone convenience function that invokes the singleton scraper's get_tax_deadlines method.

  async def get_tax_deadlines(year: Optional[int] = None) -> Dict:
      """Scrape tax deadlines from service-public.fr.
  
      Args:
          year: The tax year to retrieve deadlines for. Defaults to current year.
  
      Returns:
          Dictionary containing tax deadlines
      """
      return await service_public_scraper.get_tax_deadlines(year)