Get Recent Ganjoor Comments
ganjoor_get_recent_commentsRetrieve published Ganjoor reader comments in recency order to review poem discussions, with optional text/user filters and paging, plus Markdown or JSON output.
Instructions
Get the most recent published reader comments across Ganjoor, optionally filtered.
Comments are scholarly notes attached to a specific couplet of a poem.
Args:
term (string): Optional text filter applied to comment bodies
filter_user_id (string): Optional UUID — only comments by this user
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: For JSON: { count, page, page_size, has_more, next_page, comments: [{ id, poem_id, poem_title, couplet_index, user, text, date, has_owner_response }] }
Examples:
"What are people discussing?" -> no arguments
"Comments about 'انتظار'" -> term='انتظار'
Notes:
Ordering is by recency, so results change over time — not suitable for questions whose answer must stay stable.
Replies are not included, only top-level comments.
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_recent_comments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting from 1. | |
| term | No | Optional substring filter applied to comment text. | |
| page_size | No | Maximum items to return per page (1-100, default 20). | |
| filter_user_id | No | Optional user UUID — only that user's comments. | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |