About poetry
poetry is an MCP server for searching and retrieving poems through PoetryDB. It is suited to poetry discovery and author-focused reading, with tools for keyword searches, an author's poems, and random selections.
Key features
- 01Search poems by title or keyword
- 02Retrieve poems by author
- 03Fetch random poems
Use cases
- 01Find a poem by title or theme
- 02Explore an author's collected poems
- 03Find a poem for creative inspiration
MCP support
Exposes PoetryDB poem search, author lookup, and random poem tools to MCP clients. The README describes connection through a Pipeworx pack endpoint or the full gateway.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://gateway.pipeworx.io/poetry/mcpclaude mcp add --transport http pipeworx-io-poetry https://gateway.pipeworx.io/poetry/mcp{"mcpServers":{"pipeworx-io-poetry":{"type":"http","url":"https://gateway.pipeworx.io/poetry/mcp"}}}Open in Cursor{"servers":{"pipeworx-io-poetry":{"type":"http","url":"https://gateway.pipeworx.io/poetry/mcp"}}}Open in VS Code{"mcpServers":{"pipeworx-io-poetry":{"type":"http","url":"https://gateway.pipeworx.io/poetry/mcp"}}}{"mcpServers":{"pipeworx-io-poetry":{"serverUrl":"https://gateway.pipeworx.io/poetry/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEmcp-poetry
Poetry MCP — PoetryDB API (free, no auth)
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
search_poems | Search poems by title or keyword. Returns matching poems with full text and author information. Use when looking for a specific poem or exploring a theme. |
poems_by_author | Get all poems by a specific author (e.g., "Shakespeare", "Emily Dickinson"). Returns titles and full text. Use to explore an author's complete body of work. |
random_poems | Get random poems from the collection—specify count for multiple. Returns full text, title, and author. Use for discovery or creative inspiration. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"poetry": {
"url": "https://gateway.pipeworx.io/poetry/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Poetry data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.