npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

open-textbook-finder-mcp

v0.1.2

Published

Open Textbook Finder MCP finds free legal copies of textbooks on OpenStax, the Directory of Open Access Books and Open Library by title, ISBN or course topic, looks up editions and suggests cheaper older editions. No API key needed.

Readme

Open Textbook Finder MCP

Textbooks cost too much. Open Textbook Finder MCP finds free legal copies of textbooks on OpenStax, the Directory of Open Access Books (DOAB) and Open Library by title, ISBN or course topic. It looks up editions by ISBN and suggests older editions that usually cost less.

npx -y open-textbook-finder-mcp
  1. "Is there a free legal copy of the Calculus textbook by Stewart, or something close to it?"
  2. "Look up ISBN 978-0-13-468599-1 and tell me what other editions exist."
  3. "My course wants the 9th edition of Stewart Calculus. Is there an older edition that would work?"

npm downloads license

Use it with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and any other app that runs a local MCP server. It needs no API key and no account.

What it does

| Tool | Example prompt | | --- | --- | | find_free_textbook | "Is there a free legal copy of the Calculus textbook by Stewart, or something close to it?" | | lookup_isbn | "Look up ISBN 978-0-13-468599-1 and tell me what other editions exist." | | find_older_edition | "My course wants the 9th edition of Stewart Calculus. Is there an older edition that would work?" | | list_open_textbooks_by_subject | "List free textbooks for intro statistics." |

See Tools for the parameters of each one.

Install

Run it straight from npm with npx. You need Node.js 20 or newer, see Node version for the details. There is nothing else to install and no config file for the server itself.

npx -y open-textbook-finder-mcp

Add it to your AI app's MCP config so the app can start it for you. Every app reads its config from its own file, so pick yours:

All of them start the same server the same way. The only difference is where the config goes.

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "textbooks": {
      "command": "npx",
      "args": ["-y", "open-textbook-finder-mcp"]
    }
  }
}

Restart Claude Desktop after you save the file.

Claude Code

Run this in a terminal:

claude mcp add textbooks -- npx -y open-textbook-finder-mcp

Cursor

Cursor reads mcp.json from the project folder at .cursor/mcp.json, or from your home folder at ~/.cursor/mcp.json if you want the server in every project. On Windows the home folder file is %USERPROFILE%\.cursor\mcp.json.

{
  "mcpServers": {
    "textbooks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "open-textbook-finder-mcp"]
    }
  }
}

Restart Cursor after you save the file. The Customize page in the sidebar lists the server once it starts, and you can turn it on or off there.

VS Code

Put this in .vscode/mcp.json in your project folder, or in the mcp.json file in your user profile:

{
  "servers": {
    "textbooks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "open-textbook-finder-mcp"]
    }
  }
}

VS Code also reads a portable .mcp.json file in the project root. That file uses the name mcpServers instead of servers:

{
  "mcpServers": {
    "textbooks": {
      "command": "npx",
      "args": ["-y", "open-textbook-finder-mcp"]
    }
  }
}

Restart VS Code after you save the file.

Windsurf

Windsurf reads mcp_config.json from ~/.codeium/windsurf/mcp_config.json. On Windows that is %USERPROFILE%\.codeium\windsurf\mcp_config.json.

{
  "mcpServers": {
    "textbooks": {
      "command": "npx",
      "args": ["-y", "open-textbook-finder-mcp"]
    }
  }
}

Refresh the list of servers in Windsurf after you save the file.

After any of these, try one of the prompts below.

Try these three prompts

  1. Find a free copy

    "Is there a free legal copy of the Calculus textbook by Stewart, or something close to it?"

    The model calls find_free_textbook with that title. It checks the OpenStax list that ships with the server, then asks DOAB and Open Library. OpenStax Calculus Volume 1 comes back first, and an Open Library result is marked free only when there is a public domain copy to read online.

  2. Look up an ISBN

    "Look up ISBN 978-0-13-468599-1 and tell me what other editions exist."

    lookup_isbn checks the check digit first, then returns the title, publisher, publish date and page count from Open Library. It also lists the other editions of the same book, newest first.

  3. Find a cheaper older edition

    "My course wants the 9th edition of Stewart Calculus. Is there an older edition that would work?"

    find_older_edition lists the earlier editions of the book, closest first, with the year, the edition name and the ISBN when Open Library has them. Pass edition_year to say which edition your course asks for.

More things you can ask:

  • "List free textbooks for intro statistics."
  • "Is there a free textbook for nursing pharmacology?"
  • "Find a free legal copy of Pride and Prejudice."
  • "Which free textbooks cover microeconomics?"
  • "I have the ISBN 9780134685991. Is there a free copy of that book?"
  • "Is the 7th edition close enough to the 9th for an intro physics course?"

Tools

Four tools. These names are the ones your AI app sees.

| Tool | Parameters | What it does | | --- | --- | --- | | find_free_textbook | query, limit | Search OpenStax, DOAB and Open Library for a free legal copy by title, ISBN or course topic. Open Library results are marked free for a public domain copy and borrow for a free loan | | lookup_isbn | isbn | Return the edition details for an ISBN, say whether a free copy is known and list the related editions of the same book | | list_open_textbooks_by_subject | subject, limit | Browse free textbooks for a course topic from OpenStax and DOAB | | find_older_edition | query, edition_year, limit | Suggest earlier editions of a textbook that usually cost less, closest to the current edition first |

Every tool description sent to your AI app ends with one example prompt, so the model can match a question like "Is there a free copy of this book?" to the right tool and fill in every parameter.

Every tool also returns its results as structured data. Each tool has an output schema, so a client that reads JSON gets fields such as results or suggestions straight away, and the text answer stays the same for an app that only reads words. The fields each tool returns are listed in llms.txt and in glama.json.

Where the books come from

| Source | What it gives | How it is searched | | --- | --- | --- | | OpenStax | Free peer reviewed college textbooks | A list of OpenStax titles ships with the server and is matched on your computer, because OpenStax has no public search service | | DOAB | Open access academic books, with the licence when DOAB lists one | The DOAB search service | | Open Library | Edition records, and public domain or borrowable copies at the Internet Archive | The Open Library search and edition services |

A result has an access value. free means a copy you can read online or keep, borrow means a free loan that you have to return, and none means no free copy is known. Always check the licence on the page you land on before you reuse a book.

FAQ

Does it need an API key?

No. Open Library and DOAB can be searched without a key, and the OpenStax list ships with the server.

Does it find pirated copies?

No. It only returns OpenStax, DOAB and Open Library records, which are open licensed, public domain or legal loans.

What if I only have an ISBN?

Pass it to find_free_textbook or lookup_isbn. Hyphens and spaces are fine. The check digit is tested first, so a typo is reported as a bad ISBN instead of a search that finds nothing.

Can it tell me the price of an older edition?

No. The tool does not know prices, because no free price service exists. It tells you which earlier editions exist so you can check a used book seller yourself.

Will an older edition match my course?

Often an edition one or two releases back keeps the same chapters, but publishers reorder problems and drop sections. Compare the table of contents with your syllabus and ask your instructor before you buy.

What happens if one source is down?

The other sources still answer, and the reply names the source that did not. If every source is down the tool says so instead of returning an empty list.

How it compares

| Option | Needs a key or account | Covers | When to use | | --- | --- | --- | --- | | Open Textbook Finder MCP (this server) | No | OpenStax, DOAB and Open Library in one question, plus ISBN and edition lookups | You want your AI app to check the free options before you buy a book. | | Searching each site yourself | No | One site at a time | You already know which site has your book. | | Course platform MCPs (Brightspace, Canvas, Moodle, Google Classroom) | Your account on that platform | Due dates, grades, missing work and course files from one LMS | You want your AI app to read your course platform, not to find books. |

Open Textbook Finder MCP is a free textbook MCP: it needs no key and no account, and it finds legal copies of textbooks on OpenStax, DOAB and Open Library. The course platform MCPs above connect to your LMS account and show what is due, what is missing and what you have earned. They do not search for textbook copies. You can run both side by side, since they read different things and neither needs a key.

Node version

There are two floors here, and they are not the same number.

| What you are doing | Node.js | | --- | --- | | Running the published server | 20 or newer | | Building and testing a clone | 22.12 or newer, on the 22 and 24 release lines or 26 and later |

The server itself is happy on Node.js 20, and that is what engines in package.json says. The test runner wants a newer Node.js, so the development floor lives in devEngines in the same file. npm checks devEngines before install, run and test, so a clone on Node.js 20 stops with a clear message instead of a strange failure part way through the test suite. The 23 and 25 release lines are left out on purpose, because the test runner does not run on them.

Both numbers live in package.json, and a test in tests/node-version.test.ts keeps them in step with the README and with the range the test runner asks for.

Development

npm install
npm run build
npm test

The tests call every tool through a real MCP client with a fake network, so they need no account, no key and no internet. They need the newer Node.js from the Node version section above, because of the test runner.

Privacy

There is no key, no login and no account. The server sends your search text or ISBN to two public services and nothing else: openlibrary.org and directory.doabooks.org. The OpenStax match runs on your computer and sends nothing. The server writes no files, keeps no history and has no analytics. Each request carries a User-Agent header with the package name and the repository address, which Open Library asks of every client. Those services have their own privacy policies for the requests they receive.

More free student MCP servers

All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.

| Server | What it does | | --- | --- | | Brightspace MCP | D2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files. | | Canvas MCP | Canvas LMS for AI, read only. Due dates, missing work, grades and announcements. | | Moodle MCP | Moodle for AI, read only. Due dates, overdue work, grades and announcements. | | Google Classroom MCP | Google Classroom for AI, read only. Todos, due dates, missing work and grades. | | GPA Calculator MCP | GPA, grade conversion and the grade you need on the final, for AI. Works offline, no account. | | Citations MCP | APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account. | | Study Planner MCP | Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline. | | Paper Finder MCP | Search scholarly papers, find open access copies and related work through OpenAlex. No key needed. | | BibTeX Reference Manager MCP | Clean, convert, dedupe and lint BibTeX, RIS and CSL JSON reference lists, and make cite keys. Works offline. | | STEM Calculator MCP | Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline. | | Essay Stats MCP | Offline writing metrics for essays. Word and page counts, readability scores, passive voice, repeated openers, filler words, long sentences and word limit checks, so students can check their work against assignment requirements. No account, no network. | | Syllabus to Calendar MCP | Syllabus to calendar MCP server. Extract dates from syllabus text, build an ics calendar, expand recurring classes and merge calendars. Works offline, no account. | | Job Application Tracker MCP | Job application tracker MCP server. Track internships, jobs, interviews and deadlines offline, see what is coming up, and export your list as CSV or Markdown. No account and no API keys. |

License

MIT