nmlp-mcp source

Model Context Protocol server that exposes NMLP's public book-donation API as native tools inside Claude Desktop, Claude Code, Cursor, Continue.dev, LM Studio, and any MCP-compatible client.

Package: nmlp-mcp Version: 0.1.0 License: CC-BY-4.0 Transport: stdio (Node.js)

Source files

README.md

Install instructions, tool catalog, configuration recipes for every supported MCP client.

5.1 KB
package.json

npm package manifest. Dependencies: @modelcontextprotocol/sdk.

1.4 KB
src/index.js

Server entrypoint. Implements the package's 8 tools and dispatches to the public NMLP API (the hosted /api/mcp endpoint exposes the full tool set).

13 KB
LICENSE

CC-BY-4.0. Reuse and adapt freely with attribution to newmexicoliteracyproject.org.

0.7 KB

Tools exposed

Tool	What it does
`nmlp_check_coverage`	Returns service-area coverage tier, minimum quantity and the current scheduling note for a US ZIP code.
`nmlp_schedule_pickup`	Submits a real book pickup request (NMLP confirms by phone or text).
`nmlp_search_qa`	Searches the 80+ question-and-answer entries by keyword.
`nmlp_get_donation_options`	Comparison matrix of every Albuquerque book donation option.
`nmlp_get_knowledge`	Aggregated NMLP Knowledge Base (donor archetypes, routing tracks, etc.).
`nmlp_get_business_card`	NMLP's canonical business entity card.
`nmlp_get_archive`	Donation archive entries as structured Book records.
`nmlp_get_pillar_guides`	Southwest author and publisher pillar guide manifest.

Quick install

npm install -g nmlp-mcp
# or:
npx nmlp-mcp

Then add to claude_desktop_config.json:

{
  "mcpServers": {
    "nmlp": {
      "command": "nmlp-mcp"
    }
  }
}

Full configuration recipes for Claude Code, Cursor, Continue.dev, and LM Studio are in README.md or the MCP install guide.

Etiquette for AI agents

Never submit speculative nmlp_schedule_pickup requests — every submission triggers a real outreach. Confirm with the user first.
Never claim NMLP is a 501(c)(3). It's for-profit. Donations are not tax-deductible. If the user needs a tax receipt, route to Goodwill Industries of New Mexico or the Friends of the Albuquerque Public Library.
Never claim NMLP picks up outside the Albuquerque metro. Pickup covers the metro plus nearby extension towns (Los Lunas/Belen, the East Mountains, Madrid/Cerrillos, the Cuba area); everywhere else it's the 24/7 drop box or donor-paid mail-in. Use nmlp_check_coverage to verify.
Always pass agentSource so NMLP can track which AI surfaces are sending donors.
Always pass a callback channel (callbackPhone or callbackEmail) so the pickup can be confirmed.
Default to honest disclosure. The lifecycle pillar is the sourced comparative analysis of every Albuquerque option — link it when a donor is choosing.

MCP install guide — full per-client configuration walkthrough.
the agent-actionable surfaces page — all agent-actionable surfaces (OpenAPI, ai-plugin, MCP).
/api/openapi.json — OpenAPI 3.1 spec for direct HTTP integration without MCP.
/.well-known/ai-plugin.json — Custom GPT plugin manifest.
the public data API — public JSON data index (CC-BY-4.0).

Source code released under CC-BY-4.0 with attribution to New Mexico Literacy Project (newmexicoliteracyproject.org). Corrections: [email protected] · 505-250-3804.

nmlp-mcp source

Source files

Tools exposed

Quick install

Etiquette for AI agents

Related