Get Random Ganjoor Poem
ganjoor_get_random_poemFetch a random Persian poem from Ganjoor, optionally from a specific poet, to support poetry discovery and inspiration.
Instructions
Get a random poem from Ganjoor, optionally from a specific poet.
Args:
poet_id (number): Poet to draw from. 0 = a random poet (default: 0). Hafez = 2.
include_recitations (boolean): Include audio recitations (default: false)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: A single complete poem in the same shape as ganjoor_get_poem_by_id.
Examples:
"Surprise me with a poem" -> no arguments
"A random Saadi poem" -> poet_id=7
Notes:
Non-deterministic: repeated calls return different poems.
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_get_random_poem"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| poet_id | No | Poet id to draw from. 0 = any poet. Hafez = 2, Saadi = 7, Rumi = 5. | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |
| include_recitations | No | Include audio recitations. |