Get Ganjoor Poem Verses
ganjoor_get_poem_versesFetches ordered verses for a poem by ID, with optional single-couplet filtering, so you can return just the verse text needed instead of the complete poem.
Instructions
Get just the verses of a poem by id — a lightweight alternative to fetching the whole poem.
Each verse comes back in order with its couplet index and whether it is the first or second hemi- stich. Optionally restrict to a single couplet.
Args:
poem_id (number): Numeric poem id
couplet_index (number): Return only this couplet (0-based). Omit for the whole poem.
include_summary (boolean): Include the per-couplet prose summary (default: false)
include_original_text (boolean): Include the uncorrected original text where available (default: false)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON: { poem_id, verse_count, verses: [{ id, order, couplet_index, position, text }] }
Examples:
"Quote the verses of poem 2623" -> poem_id=2623
"Show only couplet 3" -> poem_id=2623, couplet_index=3
Notes:
Position 0 is the first hemistich, position 1 the second; couplet_index groups them.
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_verses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| poem_id | Yes | Numeric poem id. | |
| couplet_index | No | Return only this 0-based couplet. Omit to get the whole poem. | |
| include_summary | No | Include the modern Persian summary attached to each couplet. | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |
| include_original_text | No | Include the pre-correction original text where the API has it. |