PoemShip MCP Server

One poem by its id (from find_poems or a poem page URL): title, poet, language, the number of lines and stanzas, the opening of the text (a poem of 1 to 3 lines whole), a short summary when the library has one, and the links to the full poem, its analysis (when there is one) and the trainer to learn it by heart.

Today's poem of the day in a language (English by default): title, poet, opening lines (a poem of 1 to 3 lines whole) and link.

A poet in the library by name or by slug (the last part of the poet page URL): the biography (up to about 1,500 characters) and a one-line summary of it, the number of poems, up to 10 poems with links, and the poet page.

The summary of a poem and the opening of its analysis (about 1,200 characters at most), with links to the summary and analysis pages, when the library has them. Written in the language of the poem.

One collection by its slug (from library_guide or list_collections): title, introduction, link and up to 8 of its poems 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 links.

For an occasion or a feeling (a wedding, a funeral, missing someone, autumn), the library's collections of poems in a language (all languages when none is given): title, slug, a short introduction and the link. Pick the closest and call get_collection with its slug. Collections exist in English, Russian and Belarusian.

A plan to learn a poem by heart in a number of days (7 by default, 3 to 14): its stanzas and lines, which stanzas to learn on which day with a time estimate, the review days after, and the link to the free web trainer that does the drilling. No poem in mind: find_poems with easy_to_memorise suggests an easy first poem to learn.

What the library offers in one language, to turn a request into filters: the 8 moods (names in that language), the most used tags of that language (most used first) and its collections (title and slug). Call it to narrow find_poems (need, occasion, audience) with one mood and 1–3 tags, or to pick a collection for get_collection. For an easy first poem to learn by heart, find_poems with easy_to_memorise.

Search 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.