MCP server for BiblioCommons-powered public libraries — search, place holds, manage your account
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"bibliocommons-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# bibliocommons-mcp [](https://pypi.org/project/bibliocommons-mcp/) [](https://github.com/pdugan20/bibliocommons-mcp/actions/workflows/ci.yml) [](https://www.python.org/) [](https://opensource.org/licenses/MIT) MCP server for placing holds, searching, and managing your account at [BiblioCommons](https://bibliocommons.com/)-powered public libraries. ## Install ```bash pipx install bibliocommons-mcp ``` Requires Python 3.11+. ## Quick Start ```bash bibliocommons-mcp init claude mcp add bibliocommons bibliocommons-mcp --scope user ``` `init` walks the prompts, validates live against the gateway, and writes the config file for you. Manual setup: [`docs/configuration.md`](docs/configuration.md). For Claude Desktop, Cursor, or other MCP clients: [`docs/mcp-clients.md`](docs/mcp-clients.md). ## Try asking > Place a hold on something at my branch. > > Show my current holds with queue positions. > > What's due back this week? > > Cancel a hold. ## Tools All mutation tools accept a list of IDs/refs — pass `[id]` for the common single-item case. | Tool | Description | | -------------------- | ---------------------------------------------------------- | | `search` | Search the catalog, optionally filtered by format | | `availability` | Show per-branch status for a bib | | `place_hold` | Place physical holds at your pickup branch | | `borrow_digital` | Borrow one or more available digital items | | `place_digital_hold` | Join the Libby waitlist for…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.