Skip to main content
Glama
io.github.lacausecrypto/poetrydb

io.github.lacausecrypto/poetrydb

PoetryDB MCP Server

npm version CI npm total downloads Node.js License: MIT

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

io.github.lacausecrypto/poetrydb

npm package

mcp-poetry

Source API

https://poetrydb.org

Content

classic poetry by author, title, line text, and form

Related MCP server: mcp-poetry

Install

npm install -g mcp-poetry

Or from source:

npm install
npm run build

MCP Registry

This server is published to the MCP Registry under:

io.github.lacausecrypto/poetrydb

Claude 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 tools

  • catalog_category: show tools for a specific category

  • search_by_author: find poems by author name

  • search_by_title: find a poem by title

  • search_by_lines: search text inside poem lines

  • search_by_linecount: find poems by exact line count

  • search_combined: query multiple PoetryDB fields in one request

  • list_authors: list all available authors

Discovery

  • random_poem: fetch one or more random poems

  • get_sonnets: fetch 14-line poems

  • get_haikus: fetch 3-line poems

  • list_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({})
Find Ozymandias.

Expected tool:

search_by_title({ "title": "Ozymandias" })
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-run

Environment variables:

  • POETRYDB_BASE_URL

  • POETRYDB_REQUEST_TIMEOUT_MS

  • POETRYDB_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

Additional implementation notes are in documentation.md.

Available Tools

12 tools
catalog_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

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Exposes two MCP tools (discover and execute) that enable agents to query an OpenAPI schema via natural language and execute matched API operations.
      2
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables searching and retrieving poems from the PoetryDB API by title, keyword, or author, and also provides random poems for inspiration.
      6 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Exposes 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.
      12
      4
      MIT