Skip to content
MCP server

Nypl

Search and fetch NYPL Digital Collections items (photos, maps, manuscripts) from AI

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

Similar MCP servers

About Nypl

Nypl is a freemium MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

{
  "mcpServers": {
    "nypl": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/nypl/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 (2)

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

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.

What it does

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

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid credits and subscriptions for higher use

Prices change. Check pipeworx.io before you buy.

Nypl 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.

How AIPoweredBot checks servers