Skip to content
MCP server

Poetrydb

Search and fetch public-domain poems from PoetryDB via an MCP gateway, no API key needed

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Poetrydb

Poetrydb is a freemium MCP server for books and literature. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/poetrydb/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "poetrydb": {
      "url": "https://gateway.pipeworx.io/poetrydb/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid tiers from $49/month for metered usage

Prices change. Check pipeworx.io before you buy.

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.

How AIPoweredBot checks servers