Get Ganjoor Poem By URL
ganjoor_get_poemFetch a complete Persian poem from Ganjoor by URL, returning verses, metre, rhyme, and optional recitations, images, comments, and category context.
Instructions
Fetch a complete poem by its Ganjoor URL, including verses, metre, rhyme, and recitations.
This is the main way to read a poem. The URL is the same as the browser address on ganjoor.net, e.g. "hafez/ghazal/sh494". Use ganjoor_search_poems or ganjoor_list_category_poems to discover URLs, and ganjoor_get_poem_by_id when you only have a numeric id.
Args:
url (string): Poem URL slug, with or without leading slash, e.g. 'hafez/ghazal/sh494'
include_category (boolean): Include the book/category metadata (default: true)
include_siblings (boolean): Include the list of other poems in the same book (default: false)
include_recitations (boolean): Include audio recitations (default: true)
include_images (boolean): Include manuscript images (default: false)
include_comments (boolean): Include published reader comments (default: false)
include_verse_details (boolean): Include per-verse ids, positions, and couplet summaries (default: true)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Poem id, title, full title, poet, book/category path, plain text, and the ordered verse list grouped into couplets. For JSON: { id, title, full_title, full_url, poet, category, couplets_count, verses: [{ couplet_index, position, text }], recitations: [...], next_poem, previous_poem }
Examples:
"Show me Hafez's ghazal 494" -> url='hafez/ghazal/sh494'
"Read this poem with its commentary" -> include_comments=true
Notes:
Persian text is returned verbatim; it is right-to-left, so present it as-is.
Keep include_siblings and include_comments false unless needed — both can be very large.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "ganjoor_get_poem"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Ganjoor URL slug. Examples: 'hafez/ghazal/sh494', '/hafez/ghazal/sh494', 'mowhaddam/ghazal/ha1'. The leading slash is optional. | |
| include_images | No | Include manuscript image links. | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |
| include_category | No | Include the poem's category/book metadata. | |
| include_comments | No | Include published reader comments. | |
| include_siblings | No | Include all other poems in the same book. Can be very large. | |
| include_recitations | No | Include audio recitations of the poem. | |
| include_verse_details | No | Include per-verse ids, positions, and AI summaries. |