Get Ganjoor Poem By Id
ganjoor_get_poem_by_idFetch a complete poem by numeric Ganjoor id to retrieve content from search results without constructing a URL.
Instructions
Fetch a complete poem by its numeric Ganjoor id.
Same content as ganjoor_get_poem, but keyed on the numeric poem id instead of the URL. Use it when you have an id from search results or another tool and do not want to build a URL.
Args:
poem_id (number): Numeric poem id
include_category (boolean): Include the book/category metadata (default: true)
include_recitations (boolean): Include audio recitations (default: false)
include_comments (boolean): Include published reader comments (default: false)
include_verse_details (boolean): Include per-verse ids and positions plus the prose summary for each couplet (default: true). Set false for a leaner payload; the verse text itself is always returned.
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Identical shape to ganjoor_get_poem.
Examples:
"Show poem 2623" -> poem_id=2623
"What is poem 13836?" -> poem_id=13836
Notes:
Combined with ganjoor_get_page_url you can also resolve an id to its web address.
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": {
"poem_id": "<poem_id>"
},
"name": "ganjoor_get_poem_by_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| poem_id | Yes | Numeric poem id, e.g. 2623 for a Hafez ghazal. | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |
| include_category | No | Include category metadata. | |
| include_comments | No | Include reader comments. | |
| include_recitations | No | Include audio recitations. | |
| include_verse_details | No | Include per-verse ids, positions, and summaries. |