
PoetryDB MCP Server
Connects Claude to PoetryDB's public API for searching and browsing classic poetry without authentication. You get 12 tools across three categories: catalog browsing, targeted search by author, title, line text, or line count, and discovery helpers for random poems, sonnets, and haikus. The search_combined tool lets you query multiple fields at once, like finding all 14-line Shakespeare poems. Useful when you're building literary analysis workflows, need poetry datasets for testing, or want to add classic verse lookup to an assistant without maintaining your own corpus. Runs over stdio via npx, no API key needed. Built on top of thundercomb's poetrydb project.
- GitHub stars
- 2
- tools
- 12
- transport
- STDIO
- env vars
- 3
- last updated
- Apr 12, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
catalog_overviewlist categories and available tools
list categories and available tools
No parameter schema in public metadata yet.
catalog_categoryshow tools for a specific category
show tools for a specific category
No parameter schema in public metadata yet.
search_by_authorfind poems by author name
find poems by author name
No parameter schema in public metadata yet.
search_by_titlefind a poem by title
find a poem by title
No parameter schema in public metadata yet.
search_by_linessearch text inside poem lines
search text inside poem lines
No parameter schema in public metadata yet.
search_by_linecountfind poems by exact line count
find poems by exact line count
No parameter schema in public metadata yet.
search_combinedquery multiple PoetryDB fields in one request
query multiple PoetryDB fields in one request
No parameter schema in public metadata yet.
list_authorslist all available authors
list all available authors
No parameter schema in public metadata yet.
random_poemfetch one or more random poems
fetch one or more random poems
No parameter schema in public metadata yet.
get_sonnetsfetch 14-line poems
fetch 14-line poems
No parameter schema in public metadata yet.
get_haikusfetch 3-line poems
fetch 3-line poems
No parameter schema in public metadata yet.
list_titleslist poem titles
list poem titles
No parameter schema in public metadata yet.
Sponsors
Configuration
POETRYDB_BASE_URLdefault: https://poetrydb.orgOverride the PoetryDB API base URL.
POETRYDB_REQUEST_TIMEOUT_MSdefault: 20000Per-request timeout in milliseconds.
POETRYDB_REQUEST_RETRIESdefault: 2Retry count for retryable PoetryDB failures.
Readme
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 | io.github.lacausecrypto/poetrydb |
| npm package | mcp-poetry |
| Source API | https://poetrydb.org |
| Content | classic poetry by author, title, line text, and form |
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:
Details
- Repository
- github.com/lacausecrypto/mcp-poetrydb
- Website
- github.com/lacausecrypto/mcp-poetrydb
- Category
- Search & Web Crawling
- Package
mcp-poetry- Transport
- STDIO
- Registry
- MCP registry, active