
Poetrydb
Search and fetch public-domain poems from PoetryDB via an MCP gateway, no API key needed
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Poetrydb
Poetrydb is a freemium MCP server for books and literature. It can run locally on your machine or as a hosted remote server.
The Pipeworx PoetryDB server gives AI clients access to the PoetryDB archive of public-domain poetry. It exposes four PoetryDB-specific tools: a title search, a search across poem lines, a random poem fetcher, and a list of available authors. The README notes that title search does not look inside poem bodies, so phrase lookups need the line-search tool instead.
The server is a hosted endpoint on the Pipeworx gateway, reachable over streamable HTTP, and an npm package is also available as a local stdio bridge that forwards calls to the same endpoint. Anonymous use is capped daily, and an optional Pipeworx API key raises the cap; the README says calls are metered when a key is used.
It suits developers building writing or education tools, and people who want an assistant to quote or look up verse. The README also states that the endpoint lists shared gateway meta-tools alongside the four poetry tools.
Install
Run in a terminal
claude mcp add --transport http poetrydb https://gateway.pipeworx.io/poetrydb/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/poetrydb/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"poetrydb": {
"url": "https://gateway.pipeworx.io/poetrydb/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"poetrydb": {
"type": "http",
"url": "https://gateway.pipeworx.io/poetrydb/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"poetrydb": {
"serverUrl": "https://gateway.pipeworx.io/poetrydb/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"poetrydb": {
"type": "http",
"url": "https://gateway.pipeworx.io/poetrydb/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- search_poems
- Search PoetryDB for poems by title or partial title.
- get_poem_lines
- Full-text search within poem lines for a given phrase.
- random_poems
- Fetch one or more random public-domain poems.
- list_authors
- List all authors available in PoetryDB.
What it does
- Title search
- Finds poems by full or partial title and returns full text, author and line count.
- Line phrase search
- Locates poems containing a given phrase anywhere in their lines.
- Random poem fetch
- Returns one or more random public-domain poems with full text, subject to a length cap.
- Author listing
- Lists all authors available in the PoetryDB archive.
- Hosted or local connection
- Connects through a remote streamable HTTP endpoint or a local npx stdio bridge.
Good for
- Look up a poem by title to quote it in a conversation
- Find which poem contains a remembered line or phrase
- Pull random public-domain poems for a classroom or writing prompt
- Browse the list of authors available in the archive
Pricing
Freemium, from $49 a month
Anonymous 50 calls/day; free account 200 calls/day; paid tiers from $49/month for metered usage
Prices change. Check pipeworx.io before you buy.
Poetrydb FAQ
Does title search also search poem text?
No. The README says search_poems matches titles or partial titles only; use get_poem_lines to search within poem lines.
Do I need an API key?
No. Calls are anonymous and capped at 50 per day without a key; an optional free Pipeworx key raises the cap to 200 per day.
Are the poems copyrighted?
The listing describes the poems as public-domain, as the PoetryDB archive does.
Is Poetrydb free?
Poetrydb has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Poetrydb to Claude Code?
Run this command in your terminal: claude mcp add --transport http poetrydb https://gateway.pipeworx.io/poetrydb/mcp
What are the best alternatives to Poetrydb?
The closest alternatives to Poetrydb are Librivox and 海棠诗社.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.