You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat: add life events support (list_life_events, get_life_event_details) with client scraping, enable Colly AllowURLRevisit, add tests and update README/copilot wording
Copy file name to clipboardExpand all lines: README.md
+46-2Lines changed: 46 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,13 +4,15 @@ A Model Context Protocol (MCP) server that provides search and retrieval capabil
4
4
5
5
## Description
6
6
7
-
This MCP server enables AI assistants to search and retrieve official French administrative procedures and tax information. Built with Go and powered by intelligent web scraping, it provides six main capabilities:
7
+
This MCP server enables AI assistants to search and retrieve official French administrative procedures and tax information. Built with Go and powered by intelligent web scraping, it provides eight main capabilities:
8
8
9
9
### Service-Public.gouv.fr Tools
10
10
11
11
-**search_procedures**: Find relevant public service procedures and articles
12
12
-**get_article**: Retrieve complete information from specific service-public.gouv.fr articles
13
13
-**list_categories**: Browse available categories of public service information
14
+
-**list_life_events**: List all available life events (événements de vie) guides
15
+
-**get_life_event_details**: Retrieve detailed information about specific life situations
14
16
15
17
### Impots.gouv.fr Tools
16
18
@@ -237,7 +239,21 @@ After adding the configuration, restart Claude Desktop. The server will be avail
237
239
238
240
## Available Tools
239
241
240
-
The server provides six MCP tools across two domains:
242
+
The server provides eight MCP tools across two domains:
243
+
244
+
### Which Tool Should I Use?
245
+
246
+
**For major life situations** (buying a house, getting married, having a baby, death, moving, retirement, etc.):
247
+
- 🎯 **Start with `list_life_events`** - comprehensive guides organized by topic
248
+
- Then use **`get_life_event_details`** with a URL to get all procedures
249
+
250
+
**For specific administrative procedures** (passport renewal, driver's license, etc.):
251
+
- 🔍 **Use `search_procedures`** - targeted search for specific procedures
252
+
- Then use **`get_article`** to get full details
253
+
254
+
**For tax information**:
255
+
- 💰 **Use `search_impots`** for forms and tax procedures
256
+
- Then use **`get_impots_article`** for detailed information
241
257
242
258
### Service-Public.gouv.fr Tools
243
259
@@ -271,6 +287,34 @@ List available categories of public service information.
271
287
**Output:**
272
288
-`categories`: Array of available categories with name and description
273
289
290
+
#### 4. list_life_events
291
+
292
+
List all available life events (événements de vie) from the "Comment faire si" section of service-public.gouv.fr. These are comprehensive practical guides for major life situations like expecting a child, moving, retirement, etc.
293
+
294
+
**Output:**
295
+
-`events`: Array of life events with title, URL, and description
296
+
297
+
**Example events:**
298
+
- "J'attends un enfant" (Expecting a child)
299
+
- "Je déménage en France" (Moving within France)
300
+
- "Un proche est décédé" (Death of a loved one)
301
+
- "Je prépare ma retraite" (Preparing for retirement)
302
+
303
+
#### 5. get_life_event_details
304
+
305
+
Retrieve detailed information about a specific life event, including all sections organized by topic (Health, Civil Status, Employment, etc.).
306
+
307
+
**Input:**
308
+
-`url` (string): URL of the life event to retrieve (from list_life_events results)
309
+
310
+
**Output:**
311
+
-`title`: Life event title
312
+
-`url`: Life event URL
313
+
-`introduction`: Overview text
314
+
-`sections`: Array of detailed sections with title and content
0 commit comments