search_recent_documents
Find recently modified documents in RSpace by specifying a timeframe and optional text search to locate current research data.
Instructions
Search for recently modified documents
Usage: Find documents modified within a specific timeframe
Parameters:
days_back: Number of days to look back
query: Optional text search within recent documents
page_size: Number of results to return
Returns: Dictionary with recent documents
Example: search_recent_documents(7, "experiment")
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days_back | No | ||
| query | No | ||
| page_size | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- main.py:313-352 (handler)The handler function implementing the search_recent_documents tool. Registered via @mcp.tool decorator. Searches RSpace documents modified within the last N days, optionally filtered by a query string, using AdvancedQueryBuilder and eln_cli.get_documents_advanced_query.
@mcp.tool(tags={"rspace", "search"}) def search_recent_documents( days_back: int = 7, query: str = None, page_size: int = 20 ) -> dict: """ Search for recently modified documents Usage: Find documents modified within a specific timeframe Parameters: - days_back: Number of days to look back - query: Optional text search within recent documents - page_size: Number of results to return Returns: Dictionary with recent documents Example: search_recent_documents(7, "experiment") """ from datetime import datetime, timedelta # Calculate date range - RSpace expects "startDate;endDate" format for date ranges start_date = (datetime.now() - timedelta(days=days_back)).strftime("%Y-%m-%d") end_date = datetime.now().strftime("%Y-%m-%d") date_range = f"{start_date};{end_date}" builder = AdvancedQueryBuilder(operator="and") builder.add_term(date_range, AdvancedQueryBuilder.QueryType.LAST_MODIFIED) if query: builder.add_term(query, AdvancedQueryBuilder.QueryType.GLOBAL) advanced_query = builder.get_advanced_query() return eln_cli.get_documents_advanced_query( advanced_query=advanced_query, order_by="lastModified desc", page_number=0, page_size=page_size )