io.github.lacausecrypto/poetrydb
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.lacausecrypto/poetrydb Find a poem by Emily Dickinson"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PoetryDB MCP Server
Unofficial MCP server for exploring classic poetry through PoetryDB.
At a glance
Metric | Value |
Tools | 12 |
Categories | 3 |
Transport | stdio |
Auth | none |
MCP Registry name |
|
npm package |
|
Source API |
|
Content | classic poetry by author, title, line text, and form |
Related MCP server: mcp-poetry
Install
npm install -g mcp-poetryOr from source:
npm install
npm run buildMCP Registry
This server is published to the MCP Registry under:
io.github.lacausecrypto/poetrydbClaude Desktop
{
"mcpServers": {
"poetrydb": {
"command": "npx",
"args": ["-y", "mcp-poetry"]
}
}
}For a local checkout, replace the command with:
{
"mcpServers": {
"poetrydb": {
"command": "node",
"args": ["/absolute/path/to/mcp-poetrydb/dist/index.js"]
}
}
}Tools
Catalog
catalog_overview: list categories and available toolscatalog_category: show tools for a specific category
Search
search_by_author: find poems by author namesearch_by_title: find a poem by titlesearch_by_lines: search text inside poem linessearch_by_linecount: find poems by exact line countsearch_combined: query multiple PoetryDB fields in one requestlist_authors: list all available authors
Discovery
random_poem: fetch one or more random poemsget_sonnets: fetch 14-line poemsget_haikus: fetch 3-line poemslist_titles: list poem titles
Example requests
Simple
Random poem please.Expected tool:
random_poem({ "count": 1 })Browse
Show me the available poets.Expected tool:
list_authors({})Targeted search
Find Ozymandias.Expected tool:
search_by_title({ "title": "Ozymandias" })Text search
Show me poems containing the word "love".Expected tool:
search_by_lines({ "text": "love" })Form-based discovery
Give me 14-line poems by Shakespeare.Expected tool:
search_combined({ "fields": "author,linecount", "values": "Shakespeare;14" })More advanced
List Shakespeare results, but only return title and linecount.Expected tool:
search_by_author({ "author": "Shakespeare", "fields": "title,linecount" })Multi-step exploration
Start with the catalog, then show me the discovery tools, then give me a sonnet.Typical tool sequence:
catalog_overview({})
catalog_category({ "category_id": "discovery" })
get_sonnets({})Development
npm run build
npm run test:ci
npm test
npm pack --dry-runEnvironment variables:
POETRYDB_BASE_URLPOETRYDB_REQUEST_TIMEOUT_MSPOETRYDB_REQUEST_RETRIES
Notes
No API key is required.
This package is not affiliated with PoetryDB.
Built for MCP clients that prefer a compact stdio server over a custom PoetryDB integration.
MCP Registry identity:
io.github.lacausecrypto/poetrydb
Attribution
PoetryDB: poetrydb.org
Upstream project: thundercomb/poetrydb
Additional implementation notes are in documentation.md.
Available Tools
12 toolscatalog_categorycatalog_categoryB
Show the tools and description for a specific category.
Inputs: category_id (required).
catalog_overviewcatalog_overviewA
Overview of all PoetryDB MCP tools. Start here to discover categories.
Inputs: no named parameters.
get_haikusget_haikusC
Find 3-line poems, optionally filtered by author.
Inputs: author.
get_sonnetsget_sonnetsA
Find 14-line sonnets, optionally filtered by author.
Inputs: author.
list_authorslist_authorsA
List all available authors in PoetryDB.
Inputs: no named parameters.
list_titleslist_titlesA
List all poem titles in PoetryDB.
Inputs: no named parameters.
random_poemrandom_poemA
Get one or more random poems.
Inputs: count.
search_by_authorsearch_by_authorA
Find poems by author name. Supports exact or partial author matches.
Inputs: author (required), fields.
search_by_linecountsearch_by_linecountB
Find poems with a specific number of lines.
Inputs: linecount (required).
search_by_linessearch_by_linesA
Search for poems containing specific text in their lines.
Inputs: text (required).
search_by_titlesearch_by_titleC
Find a poem by title. Supports exact or partial title matches.
Inputs: title (required).
search_combinedsearch_combinedB
Run a combined PoetryDB search across multiple fields.
Inputs: fields (required), values (required), output.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have clearly distinct purposes, but get_sonnets and get_haikus overlap with search_by_linecount since 14-line and 3-line poems are special cases. An agent might be unsure whether to use the specialized get_* tools or the more general search_by_linecount.
Tool naming mixes several patterns: catalog_* (catalog_overview, catalog_category), search_by_* (search_by_author, search_by_title, etc.), list_* (list_authors, list_titles), get_* (get_sonnets, get_haikus), and random_poem (no prefix). This inconsistency can make tool selection less predictable.
With 12 tools, the count is well within the expected range for a domain-specific server. Each tool serves a distinct function and none feels superfluous or excessive for a poetry database.
The toolset covers searching, listing, and random access, along with helpful meta-tools for discovery. Minor gaps include the lack of a direct 'get poem by ID' or 'get full poem content' endpoint, which forces reliance on search results. Overall, the surface is reasonably complete for common poetry browsing workflows.
Maintenance
Related MCP Connectors
Search and read the aicoolies catalog of AI and developer tools via a remote MCP knowledge graph.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Generate contextual prompts and reusable agent skills, evaluate prompts with the 16-dimension Prompt Score, and manage saved work in PromptDrive. Twelve MCP tools also provide authorized access to private Memory for source-grounded answers. Connect over Streamable HTTP using OAuth 2.1 and PKCE. Generation consumes account quota and automatically saves successful results; Memory access follows account permissions and plan limits.
Single-connection MCP gateway discovering and executing 490+ verified MCP & A2A tools.
Related MCP Servers
- FlicenseAqualityDmaintenanceExposes two MCP tools (discover and execute) that enable agents to query an OpenAPI schema via natural language and execute matched API operations.2-
- AlicenseNot gradedqualityFmaintenanceEnables searching and retrieving poems from the PoetryDB API by title, keyword, or author, and also provides random poems for inspiration.6 npmMIT
- AlicenseAqualityBmaintenanceEnables search and retrieval of Shakespeare monologue metadata including character, play, first line, and paraphrases through various tools.941 npmMIT
- AlicenseBqualityDmaintenanceExposes 97 official Shanghai Library open data APIs and the Sou-Yun poetry database (1.99 million poems) as 12 MCP tools, covering genealogy, ancient books, calligraphy, historical buildings, and more. Enables MCP clients to query these datasets using natural language.124MIT