VosDroits

The VosDroits MCP Server connects your AI assistant to France’s public service and tax information websites.

It directly queries service-public.gouv.fr and impots.gouv.fr, pulling official, up-to-date information into your chat environment.

You can use it to find administrative procedures, look up tax forms, or get details on major life events like preparing for retirement or moving.

Features

• 🔍 Search French public service procedures and tax information
• 📄 Retrieve complete articles and form details from official sources
• 🏷️ Browse categorized administrative information
• 🎯 Access comprehensive life event guides (marriage, moving, retirement)
• 📋 Get specific tax forms and declarations
• 🐳 Run via Docker or native binaries
• 🔧 Compatible with Claude Desktop, VS Code, and Copilot CLI

Installation

Run with Docker

Pull the latest image from GitHub Container Registry and run it.

docker pull ghcr.io/guigui42/mcp-vosdroits:latest
docker run -i ghcr.io/guigui42/mcp-vosdroits:latest

Download Binaries

If you prefer not to use Docker, you can download pre-built binaries for Linux, macOS, and Windows from the project’s Releases page. Make the binary executable and run it.

# Example for Linux
curl -LO https://github.com/guigui42/mcp-vosdroits/releases/latest/download/mcp-vosdroits-linux-amd64
chmod +x mcp-vosdroits-linux-amd64
./mcp-vosdroits-linux-amd64

MCP Client Configuration

After the server is running, you need to tell your AI assistant how to connect to it.

For VSCode with GitHub Copilot

You can use the one-click install buttons on the project’s page for the easiest setup. For manual configuration, add the following to your mcp.json file.

{
  "servers": {
    "vosdroits": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/guigui42/mcp-vosdroits:latest"
      ]
    }
  }
}

For GitHub Copilot CLI

Add this configuration to your ~/.copilot/mcp-config.json file.

{
  "mcpServers": {
    "vosdroits": {
      "type": "local",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/guigui42/mcp-vosdroits:latest"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

For Claude Desktop

Add the server configuration to your claude_desktop_config.json file.

{
  "mcpServers": {
    "vosdroits": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/guigui42/mcp-vosdroits:latest"
      ]
    }
  }
}

If you are using a local binary instead of Docker, replace the "command" and "args" with the absolute path to your executable. You can also add environment variables like LOG_LEVEL within the configuration.

Available Tools

Service-Public.gouv.fr Tools

• search_procedures: Finds relevant public service procedures and articles based on a search query.
• get_article: Retrieves the complete text and details from a specific service-public.gouv.fr article URL.
• list_categories: Shows all available categories of public service information.
• list_life_events: Lists all comprehensive guides for major life events, like moving or preparing for retirement.
• get_life_event_details: Fetches the detailed information, broken down by section, for a specific life event guide.

Impots.gouv.fr Tools

• search_impots: Searches for tax forms, articles, and procedures on impots.gouv.fr.
• get_impots_article: Retrieves detailed information from a specific tax article or form URL.
• list_impots_categories: Lists the available categories for tax services, such as for individuals or professionals.

FAQs

Q: Is the information from this server legally binding?
A: The server retrieves information directly from official government sources in real-time. However, it is a tool for informational purposes and does not provide legal or tax advice. You should always verify critical information with a certified professional.

Q: How does the server stay up-to-date?
A: It uses web scraping to fetch data directly from service-public.gouv.fr and impots.gouv.fr when you make a request. This means the information is as current as what is published on those websites.

Q: Is there rate limiting or usage restrictions?
A: While the server itself doesn’t impose limits, respectful usage of public government resources is expected. The server includes configurable timeouts to prevent hanging requests.