List Ganjoor People
ganjoor_list_peopleLists historical and literary figures catalogued as related persons in Ganjoor, with optional name search and pagination, for finding people referenced in poem commentary.
Instructions
List the historical and literary figures Ganjoor has catalogued as related persons (شخصیتها).
These are people who appear in a poem's commentary or annotations — rulers, prophets, companions, poets' contemporaries — as distinct from poets themselves.
Args:
search (string): Optional filter — only people whose name contains this text
page (number): Page number, starting from 1 (default: 1)
page_size (number): Items per page, 1-100 (default: 20)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON: { total, count, page, page_size, has_more, next_page, people: [{ id, name, birth_year_hijri, death_year_hijri, birth_location, death_location, importance, gender }] }
Examples:
"Who does Ganjoor know about?" -> no arguments
"Find the person named 'حافظ'" -> search='حافظ'
Notes:
Filtering is done client-side; the full list is a few hundred entries.
importanceranks how central the person is; higher means better documented.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ganjoor_list_people"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting from 1. | |
| search | No | Case-insensitive substring filter on the person's name. | |
| page_size | No | Maximum items to return per page (1-100, default 20). | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |