pipeworx-io avatar

poetry

pipeworx-io/mcp-poetry

Wraps the PoetryDB API to let you search poems by title or keyword, pull everything by a specific author, or grab random poems for inspiration. No authentication needed. You get three straightforward tools: search_poems for finding specific works or themes, poems_by_author for exploring complete collections (Shakespeare, Dickinson, etc.), and random_poems when you want discovery over precision. Hosted on Pipeworx's gateway infrastructure, so it's streamable HTTP rather than stdio. You can call tools directly or use ask_pipeworx to handle queries in plain English. Useful when you're building anything that needs classical poetry data without API key hassle.

tools
3
transport
HTTP
last updated
Apr 1, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

search_poemsSearch poems by title or keyword. Returns matching poems with full text and author information.

Search poems by title or keyword. Returns matching poems with full text and author information.

No parameter schema in public metadata yet.

poems_by_authorGet all poems by a specific author (e.g., "Shakespeare", "Emily Dickinson"). Returns titles and full text.

Get all poems by a specific author (e.g., "Shakespeare", "Emily Dickinson"). Returns titles and full text.

No parameter schema in public metadata yet.

random_poemsGet random poems from the collection—specify count for multiple. Returns full text, title, and author.

Get random poems from the collection—specify count for multiple. Returns full text, title, and author.

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-poetry

Poetry MCP — PoetryDB API (free, no auth)

Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.

Tools

ToolDescription
search_poemsSearch 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_authorGet 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_poemsGet 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


View the full README on GitHub

Details

Repository
github.com/pipeworx-io/mcp-poetry
Website
pipeworx.io/packs/poetry
Transport
HTTP
Registry
MCP registry, active

More from pipeworx-io