List Ganjoor Poets
ganjoor_list_poetsList all poets on Ganjoor.net with biographies and IDs, so you can translate a poet’s name to the numeric ID needed by other Ganjoor tools.
Instructions
List all poets published on Ganjoor.net, including their biographies.
Returns one row per poet with: id, name, nickname, URL slug, root category id, birth/death years (Hijri), and birth/death places. Use this first when you need to translate a poet's name to a numeric id for other Ganjoor tools.
Args:
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: A paginated poet list. For JSON: { total, count, page, page_size, has_more, next_page, poets: [{ id, name, nickname, full_url, root_cat_id, birth_year_hijri, death_year_hijri, birth_place, death_place }] }
Examples:
"Who is on Ganjoor?" -> page_size=50
"List the poets born in the 10th century Hijri" -> fetch pages and filter birth_year_hijri
Notes:
Only public, read-only data. No authentication required.
The list is long (~170 poets); paginate rather than requesting page_size=100 repeatedly.
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_poets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting from 1. | |
| 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 |