@pipeworx/dpla

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/dpla’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 3

The Digital Public Library of America — ~50 million digitised items aggregated from the Library of Congress, the National Archives, the Smithsonian, HathiTrust, Internet Archive and hundreds of state libraries, universities and historical societies, searchable in one query.

Tools

• dpla_search_items(...) — search by free text, title, creator, contributing hub, subject, type, named collection or date range.
• dpla_item(id) — one record in full, including the raw source metadata as the contributing institution wrote it.
• dpla_collections(q | title) — which named collections inside contributing institutions hold matching material, with an item count each.

Auth

Platform-backed since 2026-09-18: PLATFORM_DPLA_KEY lives in the encrypted platform_keys table (no Cloudflare binding) and platformKeyEnv is declared in workers/gateway/src/pack-manifest.json, so callers need nothing. Pass your own key as _apiKey to use it instead.

The key is free, instant and self-service — no approval, no plan, no payment:

curl -XPOST https://api.dp.la/v2/api_key/<your-email>

DPLA emails the key within a minute or two.

Verify the platform key is really set with curl -s https://gateway.pipeworx.io/manifest.json → dpla.platform_key_set, never from a file on a laptop.

Data sources

• https://api.dp.la/v2/items — item search; dpla_collections is the sourceResource.collection.title facet of this same endpoint.
• https://api.dp.la/v2/items/{id} — one record.

Notes the next person would otherwise rediscover:

• /v2/collections no longer exists (fleet #2249, 2026-09-18). DPLA’s API serves exactly three routes — GET /v2/items, GET /v2/items/{id}, POST /v2/api_key/{email} (their source: github.com/dpla/dpla-api, src/index.ts). api.dp.la/v2/collections answers 404 The requested resource could not be found to a valid key, the same body it gives no key at all. An earlier version of this pack read that 404 as “bad key” because it had only ever been run without a working one. Named collections now surface only as the sourceResource.collection.title facet on the items search (facets=sourceResource.collection.title, facet_size up to 2,000), which is what dpla_collections is built on.
• A 404 from DPLA is never a key problem. A missing key and a wrong key give the identical 403 and the identical body ({"error":"invalid_api_key","message":"Invalid or inactive API key."}), checked before any other parameter is validated. So a 403 says nothing about whether the rest of the query was well formed, and a 404 says the path is gone, not that the key is. Verify a key by calling /v2/items with it, not by reading an error.
• page_size=0 does not suppress docs — it falls through to DPLA’s default page — so dpla_collections asks for one doc and ignores it.
• Filters are dotted paths into the record, not flat names: sourceResource.title, sourceResource.creator, provider.name, sourceResource.subject.name, sourceResource.collection.title, sourceResource.date.after.
• Fields are a string in one contributor’s records and an array in another’s — DPLA aggregates metadata written by hundreds of separate institutions and does not normalise cardinality. list()/one() in the pack handle both; anything reading d.sourceResource.creator[0] directly will break on some contributors. sourceResource.collection is an object with title (not name), so it has its own collectionTitles() reader.
• isShownAt is the object on the holding institution’s own site; DPLA holds the description, the institution holds the object.

Tools

• dpla_search_items — Search ~50 million digitised items aggregated by the Digital Public Library of America — photographs, letters, maps, newspapers, oral histories and books from the Library of Congress, the National Arc
• dpla_item — One DPLA record in full by its id: title, creator, date, description, subjects, language, place, format, rights statement, the institution holding the original, the DPLA hub that contributed it, a thu
• dpla_collections — Which named collections inside DPLA’s contributing institutions hold material on a topic — the curated groupings an archive defines around a subject, a donor or a project — each with how many matching