mcp-poetry logo

mcp-poetry

pipeworx-io/mcp-poetry
0 starsMITUpdated 2026-06-02Community

Is this your server?

Add your score badge to your README and get your server in front of 45k+ builders a month.

Works with

Claude CodeClaude DesktopCursorVS CodeClineCodex CLIOpenClaw+ any MCP client

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Enables searching and retrieving poems from the PoetryDB API by title, keyword, or author, and also provides random poems for inspiration.

README.md

mcp-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

See related servers & alternatives →

Related MCP servers

Browse all →

Related guides

Hand-picked reading to help you choose and use Search servers.