export_timeline
Export survey response timelines within a specified date range from LimeSurvey. Input survey ID, start date, and end date to generate detailed timeline data.
Instructions
Export timeline for a LimeSurvey survey.
Args:
sid: The survey ID.
start_date: The start date (YYYY-MM-DD).
end_date: The end date (YYYY-MM-DD).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | No | ||
| sid | Yes | ||
| start_date | No |
Implementation Reference
- main.py:352-366 (handler)The primary handler for the 'export_timeline' tool. Decorated with @mcp.tool() for automatic registration in the MCP server. Parses ISO 8601 datetime strings into datetime objects and calls the underlying LimeSurvey client's export_timeline method.@mcp.tool() def export_timeline(sid: int, period: str, start_datetime: str, end_datetime: str = None) -> str: """Export timeline for a LimeSurvey survey. Args: sid: The survey ID. period: The granularity level for aggregation submission counts ('day' or 'hour'). start_date: The start datetime (YYYY-MM-DDTHH:MM:SS) in any valid ISO 8601 format. end_date: The end datetime (YYYY-MM-DDTHH:MM:SS) in any valid ISO 8601 format. """ with get_client() as client: start_dt = datetime.fromisoformat(start_datetime) end_dt = datetime.fromisoformat(end_datetime) if end_datetime else None return client.export_timeline(sid, period, start_dt, end_dt)
- main.py:353-361 (schema)Docstring providing input schema description for the tool parameters, used by MCP for tool schema generation.def export_timeline(sid: int, period: str, start_datetime: str, end_datetime: str = None) -> str: """Export timeline for a LimeSurvey survey. Args: sid: The survey ID. period: The granularity level for aggregation submission counts ('day' or 'hour'). start_date: The start datetime (YYYY-MM-DDTHH:MM:SS) in any valid ISO 8601 format. end_date: The end datetime (YYYY-MM-DDTHH:MM:SS) in any valid ISO 8601 format. """
- main.py:352-352 (registration)The @mcp.tool() decorator registers this function as a tool in the MCP server.@mcp.tool()