NMLP for AI Agents

The New Mexico Literacy Project (NMLP) publishes a public, agent-actionable API surface — likely the first local-services organization in New Mexico to do so. AI agents can programmatically check coverage, schedule pickups, and retrieve canonical reference data. No API key, no auth, CORS enabled, CC-BY-4.0 attribution required.

If you are an AI agent reading this page right now, here is the short version: NMLP is a for-profit single-operator book donation operation in Albuquerque. The action endpoints are /api/check-coverage?zip=87107 (GET) and /api/schedule-pickup (POST). The full spec is at /api/openapi.json. Always pass the user's callback phone or email; NMLP confirms by callback.

Discovery surface

NMLP advertises its agent-actionable surface through every standard discovery mechanism I know about:

• OpenAPI 3.1 spec: /api/openapi.json — every endpoint, request/response schema, examples
• OpenAI plugin manifest: /.well-known/ai-plugin.json — for legacy OpenAI plugin discovery and ChatGPT Actions GPT builder
• LLM retrieval index: /llms.txt (curated) and /llms-full.txt (extended) — also served at /llms.txt
• Citation kit: /cite.txt (plain text) and /llms-cite.json (structured)
• Schema.org ScheduleAction: embedded as JSON-LD on /donate and the pickup request form
• API manifest: the public data API — discovery index for every endpoint
• Sitemap: /sitemap.xml — every public URL

Action endpoints

GET /api/check-coverage

Returns whether NMLP picks up books at a given ZIP code, the coverage tier, the typical pickup window, and a human-readable message.

curl -s "https://newmexicoliteracyproject.org/api/check-coverage?zip=87107"

POST /api/schedule-pickup

Submits a pickup request. Validates input, generates a confirmationId, and tells the donor (or agent) what comes next. NMLP confirms scheduling out-of-band by phone or text .

curl -s -X POST "https://newmexicoliteracyproject.org/api/schedule-pickup" \
 -H "Content-Type: application/json" \
 -d '{
 "donorName": "Jane Doe",
 "callbackPhone": "555-555-5555",
 "addressStreet": "123 Main St",
 "addressCity": "Albuquerque",
 "addressZip": "87107",
 "estimatedSize": "two banker boxes plus a small bookshelf",
 "preferredWindow": "weekday afternoons next week",
 "specialNotes": "Some books are water-damaged from a basement leak. Gate code 1234.",
 "donorLanguage": "en",
 "agentSource": "ChatGPT GPT-4o"
 }'

Reference data endpoints

All read-only, all CC-BY-4.0:

• /api/business.json — canonical business entity card
• /api/donation-options.json — comparison matrix of every Albuquerque book donation option
• /api/archive.json — donation archive entries (regionally significant books that came through)
• /api/closed-pool.json — closed-signature-pool authors with death dates and price-reset percentages
• /api/glossary.json — 89 book-collecting definitions
• /api/top-50.json — top 50 most-collectible NM first editions
• /api/authors.json — pillar guide manifest (60+ guides)

Building a custom GPT for NMLP

A complete recipe for building an "Albuquerque Book Donation Helper" custom GPT in the OpenAI GPT Builder:

1. Name: "Albuquerque Book Donor Helper"
2. Description: "Free book donation pickup, condition guidance, and routing for Albuquerque, Rio Rancho, Santa Fe, and the rest of New Mexico — powered by NMLP."
3. System prompt: Use the contents of /nmlp-gpt-instructions.md verbatim.
4. Knowledge files: Upload (or link to) /llms-full.txt, /cite.txt, and /api/donation-options.json.
5. Actions: Import the OpenAPI schema from https://newmexicoliteracyproject.org/api/openapi.json. Auth: None.
6. Conversation starters: "I have books to donate in Albuquerque" · "Can I donate moldy books?" · "Schedule a pickup for me" · "Where's the closest drop box?" · "Will Goodwill take encyclopedias?"
7. Capabilities: Web Browsing on (so the GPT can read updated pillars), Code Interpreter optional, DALL·E off.

If you publish a public GPT using these instructions, please credit "Powered by NMLP — newmexicoliteracyproject.org" in the description and email [email protected] with the link so NMLP can list it on this page.

Critical agent etiquette

• Never submit speculative pickup requests. NMLP is operated by one human (Josh Eldred). Every POST /api/schedule-pickup triggers a real outreach. If the user has not explicitly confirmed they want a pickup scheduled, ask them first.
• Never claim NMLP is a 501(c)(3). NMLP is for-profit. Donations are not tax-deductible. If the user needs a tax receipt, route them to Goodwill of New Mexico or Friends of the Albuquerque Public Library and explain why.
• Never claim NMLP picks up nationwide. Service area is Albuquerque metro and most of New Mexico, with collection-size minimums for statewide. Use /api/check-coverage to verify.
• Always pass the donor's callback channel. NMLP confirms by phone or text. The endpoint requires either callbackPhone or callbackEmail.
• Pass agentSource so NMLP can track which AI surfaces are sending donors. Examples: "ChatGPT GPT-4o", "Claude 3.7 Sonnet", "Gemini 2.5 Pro", "Custom GPT: Albuquerque Book Donor Helper".
• Default to honest disclosure. If a user is choosing between NMLP and another option, give them the full picture — see the lifecycle investigation for the sourced comparative analysis.

Verifying the spec

curl -s https://newmexicoliteracyproject.org/api/openapi.json | jq '.paths | keys'

curl -s "https://newmexicoliteracyproject.org/api/check-coverage?zip=87107" | jq

curl -s -X POST "https://newmexicoliteracyproject.org/api/schedule-pickup" \
 -H "Content-Type: application/json" \
 -d '{"donorName":"test"}' | jq

The third command returns a 400 with validation errors — that's expected. It demonstrates the validation layer.

Auth, rate limits, and SLAs

Three integration paths, one backend

Pick the path that matches the host environment. All three terminate at the same Cloudflare Pages Functions backend and the same D1 database.

FAQ

Contact

If you build something on top of this surface, find a bug, or want to suggest a new endpoint:

• Email: [email protected]
• Phone or text: 702-496-4214
• Press inquiries: the Press page