# Poetrydb

> Poetrydb is a freemium MCP server for books and literature. Search and fetch public-domain poems from PoetryDB via an MCP gateway, no API key needed. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/poetrydb
- **Repository:** https://github.com/pipeworx-io/mcp-poetrydb
- **MCP Registry name:** io.github.pipeworx-io/poetrydb
- **Categories:** [books and literature](https://ai-powered.com/categories/books-and-literature)
- **Listing updated:** 2026-11-18

## About

The Pipeworx PoetryDB server gives AI clients access to the PoetryDB archive of public-domain poetry. It exposes four PoetryDB-specific tools: a title search, a search across poem lines, a random poem fetcher, and a list of available authors. The README notes that title search does not look inside poem bodies, so phrase lookups need the line-search tool instead.

The server is a hosted endpoint on the Pipeworx gateway, reachable over streamable HTTP, and an npm package is also available as a local stdio bridge that forwards calls to the same endpoint. Anonymous use is capped daily, and an optional Pipeworx API key raises the cap; the README says calls are metered when a key is used.

It suits developers building writing or education tools, and people who want an assistant to quote or look up verse. The README also states that the endpoint lists shared gateway meta-tools alongside the four poetry tools.

## Features

- **Title search:** Finds poems by full or partial title and returns full text, author and line count.
- **Line phrase search:** Locates poems containing a given phrase anywhere in their lines.
- **Random poem fetch:** Returns one or more random public-domain poems with full text, subject to a length cap.
- **Author listing:** Lists all authors available in the PoetryDB archive.
- **Hosted or local connection:** Connects through a remote streamable HTTP endpoint or a local npx stdio bridge.

## Good for

- Look up a poem by title to quote it in a conversation
- Find which poem contains a remembered line or phrase
- Pull random public-domain poems for a classroom or writing prompt
- Browse the list of authors available in the archive

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http poetrydb https://gateway.pipeworx.io/poetrydb/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/poetrydb/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "poetrydb": {
      "url": "https://gateway.pipeworx.io/poetrydb/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "poetrydb": {
      "serverUrl": "https://gateway.pipeworx.io/poetrydb/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "poetrydb": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/poetrydb/mcp"
    }
  }
}
```

## Tools

- `search_poems`: Search PoetryDB for poems by title or partial title.
- `get_poem_lines`: Full-text search within poem lines for a given phrase.
- `random_poems`: Fetch one or more random public-domain poems.
- `list_authors`: List all authors available in PoetryDB.

## FAQ

### Does title search also search poem text?

No. The README says search_poems matches titles or partial titles only; use get_poem_lines to search within poem lines.

### Do I need an API key?

No. Calls are anonymous and capped at 50 per day without a key; an optional free Pipeworx key raises the cap to 200 per day.

### Are the poems copyrighted?

The listing describes the poems as public-domain, as the PoetryDB archive does.

### Is Poetrydb free?

Poetrydb has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Poetrydb to Claude Code?

Run this command in your terminal: claude mcp add --transport http poetrydb https://gateway.pipeworx.io/poetrydb/mcp

### What are the best alternatives to Poetrydb?

The closest alternatives to Poetrydb are Librivox and 海棠诗社.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Librivox](https://ai-powered.com/mcp/librivox): Librivox is a freemium MCP server for books and literature.
- [海棠诗社](https://ai-powered.com/mcp/listing-mwenxcq0): 海棠诗社 is a free MCP server for books and literature.

---
Source: https://ai-powered.com/mcp/poetrydb
