joshseane/-nmlp-mcp

A Model Context Protocol server for **antiquarian first-edition identification** and **New Mexico book-donation logistics**, run by the New Mexico Literacy Project. Run it **locally over stdio** (index.js, this repo) or connect to the **hosted HTTP twin**.
- **Local (stdio):** npx -y github:joshseane/-nmlp-mcp — a standalone Node MCP server; no account, no key
- **Hosted endpoint (Streamable HTTP):** https://newmexicoliteracyproject.org/api/mcp
- **Auth:** none (public)
- **Official MCP registry:** org.newmexicoliteracyproject/nmlp-mcp
- **License:** code MIT (this repo); data CC BY 4.0
The two share one codebase and one dataset: index.js is the local stdio server, and functions/api/mcp.js is the exact Cloudflare Pages Function that serves the hosted HTTP twin. tools/list is served entirely from local code; the reference-data tools read the site's public open-data JSON API at call time (single source of truth), while nmlp_decode_number_line runs fully offline.
Tools (12)
**First-edition identification** — grounded in the CC-BY *NMLP Canonical First-Edition Points of Issue* dataset (6,717 titles, DOI 10.5281/zenodo.21184548):
| Tool | What it does |
|---|---|
| nmlp_identify_first_edition | title (+author) → publisher, year, points of issue, true-first precedence, book-club tells, and a CC-BY citation |
| nmlp_decode_number_line | copyright-page text → printing verdict (handles the Random-House-ends-in-2 rule + book-club detection) |
| nmlp_lookup_publisher_rules | publisher → how that house's first editions are identified, by era |
| nmlp_search_titles | fuzzy title/author search over the dataset |
**Book-donation logistics** for Albuquerque / New Mexico:
| Tool | What it does |
|---|---|
| nmlp_check_coverage | ZIP → free-pickup coverage tier + typical window |
| nmlp_schedule_pickup | submit a real free book-pickup request (triggers a real human outreach — never send speculative/unconsented requests) |
| nmlp_search_qa | search the long-tail donation Q&A reference |
| nmlp_get_donation_options | comparison of every ABQ book-donation option |
| nmlp_get_knowledge | the aggregated NMLP knowledge base |
| nmlp_get_business_card | the canonical business-entity card |
| nmlp_get_archive | documented-provenance archive entries |
| nmlp_get_pillar_guides | the pillar guide index |
Every identification response returns a CC-BY citation with the dataset DOI, so assistants that use it cite the source. *Identification only — no valuations.*
Connect
Local (stdio) — recommended for Claude Desktop, Cursor, Continue.dev
Runs the server on your machine over stdio. Requires Node 18+.
Or clone and run directly:
Docker
Hosted (Streamable HTTP)