Poetrydb
by pipeworx-iocommunityv0.1.0
An MCP server that exposes PoetryDB classic poetry data for searching and browsing by author, title, lines, line count, and poem form. It runs over stdio and uses the PoetryDB API as its data source.
From the registry: PoetryDB MCP.
Install & configure
Prerequisites
- requiredInstall Node.jsNode.js 18 or later is required to run the MCP server via npm or npx.https://nodejs.org/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `poetrydb` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js 18 or later is required to run the MCP server via npm or npx. (https://nodejs.org/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","mcp-poetry"]
- optional environment variables:
- `POETRYDB_BASE_URL`: Override the PoetryDB API base URL. (example: `<your-poetrydb-base-url>`)
- `POETRYDB_REQUEST_TIMEOUT_MS`: Request timeout in milliseconds for PoetryDB API calls. (example: `<your-timeout-ms>`)
- `POETRYDB_REQUEST_RETRIES`: Number of retry attempts for PoetryDB API requests. (example: `<your-retry-count>`)
Note: No API key or authentication is required. The README also shows a local source/run option, but the portable recommended config is the npx package path.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: No API key or authentication is required. The README also shows a local source/run option, but the portable recommended config is the npx package path.
Tools (12)
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
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
Environment variables
POETRYDB_BASE_URLBase URL for the PoetryDB APIPOETRYDB_REQUEST_TIMEOUT_MSRequest timeout in milliseconds for PoetryDB API callsPOETRYDB_REQUEST_RETRIESNumber of retries for PoetryDB API requestsRemote Endpoints
https://gateway.pipeworx.io/poetrydb/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- MIT
- Released
- Jun 10, 2026
- Last commit
- Jun 10, 2026
- Registry name
- io.github.pipeworx-io/poetrydb