What can you do with poetry?

mcp-poetry

Poetry MCP — PoetryDB API (free, no auth)

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

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.

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"
    }
  }
}

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.

MIT

Add poetry to your client. Pick the one you use.

claude mcp add --transport http poetry https://gateway.pipeworx.io/poetry/mcp

codex mcp add poetry --url https://gateway.pipeworx.io/poetry/mcp

{
  "mcpServers": {
    "poetry": {
      "url": "https://gateway.pipeworx.io/poetry/mcp"
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "servers": {
    "poetry": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/poetry/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

{
  "mcpServers": {
    "poetry": {
      "url": "https://gateway.pipeworx.io/poetry/mcp"
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "poetry": {
      "serverUrl": "https://gateway.pipeworx.io/poetry/mcp"
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

poetry exposes 3 tools to a connected agent.

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.

57 / 100

Adequate

Versions	Published
0.1.0Latest	Apr 1, 2026