# Nypl

> Nypl is a freemium MCP server for knowledge and memory. Search and fetch NYPL Digital Collections items (photos, maps, manuscripts) from AI. 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/nypl
- **Repository:** https://github.com/pipeworx-io/mcp-nypl
- **MCP Registry name:** io.github.pipeworx-io/nypl
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

The NYPL Digital Collections server gives an AI assistant two lookups against the New York Public Library's digitised archive: a keyword search that returns item ids, titles, creators, dates and links, and a fetch that pulls full details for one item by its NYPL uuid. The README describes the server as an unofficial integration run through the Pipeworx MCP gateway, so requests travel through that gateway rather than directly to NYPL.

Beyond the two NYPL tools, a connection to the endpoint also lists shared gateway tools such as ask_pipeworx, which routes a plain-English question to the right source. The README notes this extra set adds to the tool count a client sees. Access works anonymously with a daily call cap, and a free Pipeworx key raises that cap.

The server suits researchers, students and developers who want an agent to find historical photographs, maps or prints from the NYPL collection and cite the item pages.

## Features

- **Keyword collection search:** Searches the NYPL Digital Collections by keyword and returns matching items with ids, titles, creators and dates.
- **Item detail lookup:** Fetches full details for a single item using the NYPL uuid returned by search.
- **Plain-English routing:** Shared ask_pipeworx tool can answer questions in natural language by choosing the right tool and arguments.
- **Anonymous or keyed access:** Works without an account at a daily cap; an optional free API key raises the limit.
- **Multiple install paths:** Can be added as a remote streamable-http endpoint or run locally via npx as a stdio bridge.

## Good for

- Find historical photographs of a city or event for a research report
- Locate old maps or prints in a public archive from an AI chat client
- Pull item metadata and links to cite NYPL sources
- Let a coding or writing agent look up archival images by keyword

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `search`: Search the NYPL Digital Collections collection by keyword. Returns matching items with ids, titles, creators/sources, dates and links.
- `item`: Fetch full details for one NYPL Digital Collections item by id, an NYPL item uuid from search.

## FAQ

### Is this an official NYPL product?

No. The README says it is an independent, unofficial integration and not affiliated with or endorsed by the New York Public Library.

### Do I need an API key?

No. Calls are anonymous and capped at 50 a day. A free Pipeworx account raises the cap to 200 a day.

### Which tools does the server expose?

The pack's own tools are search and item. The endpoint also lists shared gateway tools such as ask_pipeworx and remember/recall.

### Can I run it without the hosted gateway?

The npm package is a local stdio bridge that forwards every call to the hosted gateway endpoint, and the README says it needs network access with no offline mode.

### Is Nypl free?

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

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

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

### What are the best alternatives to Nypl?

The closest alternatives to Nypl are Digitalnz, Smithsonian, Harvard Art, Europeana and Trove.

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

- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Smithsonian](https://ai-powered.com/mcp/smithsonian): Smithsonian is a freemium MCP server for knowledge and memory.
- [Harvard Art](https://ai-powered.com/mcp/harvard-art): Harvard Art is a freemium MCP server for knowledge and memory.
- [Europeana](https://ai-powered.com/mcp/europeana): Europeana is a freemium MCP server for knowledge and memory.
- [Trove](https://ai-powered.com/mcp/trove-3): Trove is a freemium MCP server for knowledge and memory.
- [Hathitrust](https://ai-powered.com/mcp/hathitrust): Hathitrust is a freemium MCP server for knowledge and memory.
- [Sciencebase](https://ai-powered.com/mcp/sciencebase): Sciencebase is a freemium MCP server for knowledge and memory.
- [Wordnik](https://ai-powered.com/mcp/wordnik): Wordnik is a freemium MCP server for knowledge and memory.

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