sd_filter_letters
Filter letters by sender, receiver, place, and time period to focus your correspondence analysis.
Instructions
Filter letters by sender, receiver, place, and time period.
PURPOSE: Filter letters by specific criteria (FAST - uses cache)
WHEN TO USE:
User asks "letters from/to person X"
User asks "letters from Berlin"
User asks "letters between 1810 and 1815"
For correspondence network analyses
WHEN NOT TO USE:
For keyword search → use search_by_keyword()
For register search → use search_register()
Args: sender: Person ID of sender (from register, e.g., "S0003676") receiver: Person ID of receiver (from register, e.g., "S0003677") send_place: Place ID or name of sending location (e.g., "S0000065" or "Berlin") not_before: Earliest date (ISO 8601, e.g., "1810-01-01") not_after: Latest date (ISO 8601, e.g., "1815-12-31") max_results: Maximum results ctx: FastMCP Context
Returns: List of Letter objects
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sender | No | ||
| receiver | No | ||
| not_after | No | ||
| not_before | No | ||
| send_place | No | ||
| max_results | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |