Find poems
find_poemsSearch the library. For a situation or a wish ("I just lost my dad", "a poem to thank my mother", "something calm for a ten-year-old", "an easy first poem to learn by heart"), set what the reader needs first: need, or occasion and recipient for a poem to send, audience, easy_to_memorise, easy_to_read. Narrow it with one mood or 1–3 tags from library_guide in the poem language, and max_lines for a short poem. Words in query are looked for in the title and text and in what the poem is about, so "grief father" finds poems of a father's death. For a poem or line the user remembers, put its words in query. Returns up to 10 poems, the best fit first, with the poet, the number of lines, the opening lines (a poem of 1 to 3 lines whole), one sentence on what the poem feels like (use it to choose, it is not the poet's words) and the link. need, occasion, recipient, easy_to_memorise, easy_to_read and audience cover English, Russian and Belarusian poems. Give at least one filter. When nothing fits, or the user wants a deeper search by mood or situation, give them the Smart Search link from the result: a page of the site where they describe it in their own words.
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": "find_poems"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mood | No | One library mood: sad, anxious, angry, contemplative, inspiring, romantic, dreamy or joyful, or its name in the poem language from library_guide. | |
| need | No | What the reader wants the poem to do for them: comfort (consoling words for someone who suffers), calm (stillness, a gentle pace), hope (ends more hopeful than it begins), energy (courage, action), release (a good cry), perspective (troubles set against something larger), feel_understood (a painful feeling put into words and left as it is), smile (funny or playful) or tenderness (love toward someone). Only poems that clearly do it come back, the best fit first. | |
| tags | No | Tags from library_guide in the poem language, for example ["grief", "father"]. A poem matches any of them. | |
| limit | No | ||
| query | No | Words in any order, looked for in the title, the text and what the poem is about. Every word must appear. Poems with all of them in the title come first. When no poem has them all, poems with any of them come back and the result says so. | |
| author | No | The poet's name or part of it, for example "Dickinson". | |
| audience | No | children (up to 12), teens or anyone. Leaves out poems not suited to that age. With this or any of need, occasion, recipient, easy_to_memorise and easy_to_read, explicit poems are left out. | |
| language | No | Language of the poems, an ISO 639-1 code: en, ru, be, de, fr, es, it, pl, nl, sv, da, nb or uk. | |
| occasion | No | For a poem to send someone as a personal message: greeting (good morning, good night, thinking of you), romance, thanks, celebration (birthday, wedding, newborn, graduation), holiday, support (illness, hard times, before a challenge), condolence, apology, farewell, blessing or friendship. Only poems that read as a message in the sender's own words come back. | |
| max_lines | No | Only poems of at most this many lines. | |
| recipient | No | Who the poem is sent to: partner, friend, parent, child or anyone. Poems for that person come first, then poems that suit anyone. | |
| easy_to_read | No | Only poems in plain language a teenager follows on first reading. | |
| easy_to_memorise | No | Only poems easy to learn by heart (steady rhythm and rhyme, not long), the easiest first. For a first poem to learn. |