mcpField
O
open-textbook-finder-mcp

open-textbook-finder-mcp

Local
brightspacemcp.comSearch0Updated 2d ago

About open-textbook-finder-mcp

An MCP server for students that finds legal free textbooks by title, ISBN, or course topic and looks up edition details. It combines results from OpenStax, DOAB, and Open Library without requiring an API key or account.

Key features

  1. 01Search by title, ISBN, or topic
  2. 02Look up ISBN editions and related editions
  3. 03Find earlier editions
  4. 04Browse open textbooks by subject
  5. 05Label free, borrowable, or unavailable copies

Use cases

  1. 01Find legal free copies before buying a textbook
  2. 02Check editions associated with an ISBN
  3. 03Look for an earlier edition for a course
  4. 04Browse open textbooks by course topic

MCP support

The MCP server provides tools for textbook search, ISBN lookup, subject browsing, and older-edition discovery. Searches send query text or ISBN to Open Library and DOAB; OpenStax matching runs locally.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"anonymousonyx22-open-textbook-finder": {
"command": "npx",
"args": [
"-y",
"open-textbook-finder-mcp"
]
}
}
}
Run commandnpx -y open-textbook-finder-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmopen-textbook-finder-mcp0.1.0

Tools

4

Saved tool list · updated 1d ago

ParameterTypeRequiredDescription
limitintegerNoHow many results to return, 1 to 10. Defaults to 5.
querystringYesA textbook title, an ISBN (10 or 13 digits, hyphens allowed) or a course topic.

Details

From the project 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

ToolExample 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.

ToolParametersWhat it does
find_free_textbookquery, limitSearch 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_isbnisbnReturn 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_subjectsubject, limitBrowse free textbooks for a course topic from OpenStax and DOAB
find_older_editionquery, edition_year, limitSuggest 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

SourceWhat it givesHow it is searched
OpenStaxFree peer reviewed college textbooksA list of OpenStax titles ships with the server and is matched on your computer, because OpenStax has no public search service
DOABOpen access academic books, with the licence when DOAB lists oneThe DOAB search service
Open LibraryEdition records, and public domain or borrowable copies at the Internet ArchiveThe 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

OptionNeeds a key or accountCoversWhen to use
Open Textbook Finder MCP (this server)NoOpenStax, DOAB and Open Library in one question, plus ISBN and edition lookupsYou want your AI app to check the free options before you buy a book.
Searching each site yourselfNoOne site at a timeYou already know which site has your book.
Course platform MCPs (Brightspace, Canvas, Moodle, Google Classroom)Your account on that platformDue dates, grades, missing work and course files from one LMSYou 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 doingNode.js
Running the published server20 or newer
Building and testing a clone22.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.

ServerWhat it does
Brightspace MCPD2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files.
Canvas MCPCanvas LMS for AI, read only. Due dates, missing work, grades and announcements.
Moodle MCPMoodle for AI, read only. Due dates, overdue work, grades and announcements.
Google Classroom MCPGoogle Classroom for AI, read only. Todos, due dates, missing work and grades.
GPA Calculator MCPGPA, CGPA, weighted grades, target grades and final exam math. Works offline.
Citations MCPAPA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account.
Study Planner MCPExam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline.
Paper Finder MCPSearch scholarly papers, find open access copies and related work through OpenAlex. No key needed.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.