CONTENTdm State Archives

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ianderso-contentdm-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Nov 1, 2026.

Tools

7 read · 0 write · 0 delete · 1 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (8)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• cache_status

  Report this session's requests, by site, and cache use. Makes no network call.

• get_collection

  Read one collection's fields: what search's `field` can name, and which hold text. Field names are per collection: the same label has different nicks on different collections, and `full_text` (a transcript or OCR) is marked by type, whatever it is called.

• get_image

  Download one page image through the site's IIIF service, so it can be read. This is the step that turns a hit into evidence. The image is written as a JPEG to `destination`, never returned inline: a new .jpg or .jpeg file, not hidden, not under ~/Library, and inside the operator's download folder when one is set. Audio and video cannot be rendered. Cite the page by the `citation` returned, not by the file.

• get_item

  Read one item: its metadata, any transcript or OCR text, and how to cite it. `text` is a lead, not the record: read the image (get_image). A compound object's own text is usually empty; its pages carry it (get_pages). For a page, `page_of` names the object and page number. `cite_as` is the institution's own citation where it gives one; `rights` its terms. An address on an unlisted site's own domain is refused: use its cdmNNNNN.contentdm.oclc.org form.

• get_pages

  List a compound object's pages in order, each with its own number and address. A volume, a file or a newspaper issue is one compound object of many pages, and each page is an item with its own pointer. A PDF page can itself hold several pages: get_image's pdf_page reaches them. `query` marks which pages match, which is how to find a name in a long index.

• list_collections

  List a site's collections and the alias each is searched by. Use the alias, not the short number some sites put in their web addresses. A site that lists no collections has usually moved elsewhere.

• list_instances

  List the curated CONTENTdm sites, and any the operator added: who runs each, what it holds. Makes no network call. Each `instance` value is what the other tools take. Sites that have left CONTENTdm stay listed with where they went. Any other CONTENTdm site works by its https://cdmNNNNN.contentdm.oclc.org address, which every site has; other hosts are refused.

• search

  Search one CONTENTdm site, or several side by side, for items or pages. `answered`, `failed`, `timed_out` and `not_searched` say which sites the answer covers: a negative is only as wide as `answered`. Matching covers metadata and any transcript or OCR field, never the image itself, and many record images have no text at all. A compound object's text is on its pages: use page_hits=true, or get_pages with a query, to find the page. Hits are leads: open the item and read the image.

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

36

Last commit

Oct 6, 2026 (26 days ago)

Last release

Oct 6, 2026 (26 days ago)

Last package publish

Oct 6, 2026 (26 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.ianderso/contentdm-mcp

Version

0.1.0

Auth

No auth

Packages

pypi contentdm-mcp

License

MIT

Repository

github.com/ianderso/contentdm-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql