Ontwikkelaars

De catalogus van de bibliotheek, de gratis boekenplank en de gedrukte uitgaven zijn toegankelijk voor programma's, assistenten en modellen via negentien openbare tools met alleen leestoegang. Je hebt geen sleutel nodig en hoeft je nergens voor aan te melden. Zeven andere tools lezen iemands eigen bibliotheek zodra die persoon het eigen account aan de assistent koppelt (zie Je eigen bibliotheek). De tools melden niemand aan, innen geen betalingen en veranderen niets: elke titel wordt teruggegeven met het adres van de bijbehorende pagina op libraryofalexandria.com, waar je kunt lezen, luisteren, afdrukken of beginnen.

Drie manieren om toegang te krijgen

MCP (Streamable HTTP) op https://mcp.libraryofalexandria.com/mcp: voor Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose en elke andere MCP-client.
REST en OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> en het OpenAPI-bestand op https://api.libraryofalexandria.com/v1/openapi.json: voor scripts, automatiseringstools (n8n, Zapier, Make, Dify, Flowise), Open WebUI-toolservers en Copilot Studio.
Toolbestanden voor modelbouwers: GET https://api.libraryofalexandria.com/v1/tools?format=openai: voor elk programma dat tooldefinities aan een model doorgeeft. De formaten zijn openai, openai-chat, anthropic, gemini, ollama en mcp.

Probeer het in een minuut

curl -s https://api.libraryofalexandria.com/v1/search_books \
  -H 'content-type: application/json' \
  -d '{"query":"moby dick","limit":3}'

Het antwoord is {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Elke titel in data.results heeft een id, een title, een author en de url van de bijbehorende pagina.

De negentien tools

Acht tools zoeken een titel op, één toont de gedrukte uitgaven, vier bereiden een persoonlijk gedrukt exemplaar voor en zes helpen je bij het studeren en kiezen. Kies welke tools een assistent ziet met ?toolset= in het MCP-adres; een korte lijst is geschikt voor kleine lokale modellen:

https://api.libraryofalexandria.com/mcp: de negentien openbare tools, zonder aanmelding (het adres in onze vermeldingen in overzichten).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: dezelfde negentien openbare tools.
?toolset=catalogue,orders: de dertien tools die een titel opzoeken, de gedrukte uitgaven tonen en een persoonlijk gedrukt exemplaar voorbereiden.
?toolset=study: de zes studietools.
https://mcp.libraryofalexandria.com/mcp zonder toolset: de negentien openbare tools en de zeven tools voor iemands eigen bibliotheek, zesentwintig in totaal; die zeven antwoorden alleen met toestemming van die persoon.

search_books (query, language, limit): zoek titels met woorden uit een titel, een auteursnaam of een onderwerp, in elke taal van de catalogus.
get_book (id, language): de gegevens van één titel: auteur, oorspronkelijke titel, omslag, gedrukte uitgaven en de bijbehorende pagina in elke taal.
get_summary (id, language, part): het volledige eerste kernidee uit de Samenvatting in 15 minuten van één titel, en de koppen van de overige kernideeën.
get_sample (id, language, page): het gratis begin van één titel, in pagina's van maximaal 400 woorden.
list_free_shelf (language, subject, limit): de titels op de gratis boekenplank, op taal en onderwerp.
read_free_chapter (id, chapter, page, language): één hoofdstuk van een titel op de gratis boekenplank, in pagina's van maximaal 400 woorden.
get_print_options (id, language): de gedrukte uitgaven van één titel (standaard en in grote letters, als paperback of gebonden boek) met de prijs van elke uitgave in Amerikaanse dollars.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): de prijs van een gedrukt exemplaar van één titel met een pagina voor een persoonlijke boodschap, het totaalbedrag voor het aantal exemplaren en de pagina waar je de boodschap schrijft en de bestelling plaatst.
get_cover_upload_link (id, language): de pagina waar je een eigen omslagafbeelding toevoegt aan een gedrukt exemplaar.
create_custom_print_order (quote_id): de pagina waar je de boodschap schrijft, de drukproef bekijkt en betaalt. Via de assistent wordt niets besteld of betaald.
get_order_status (order_ref, email, language): de status van een bestelling van gedrukte boeken.
get_publisher_info: wie de bibliotheek uitgeeft, de beschikbare talen, de voorwaarden en de privacypagina.
browse_collection (collection, language, limit, cursor): een samengestelde boekenplank, met acht titels tegelijk: de gratis boeken, de boeken op makkelijk, gemiddeld of uitdagend niveau, de verloren boeken, de titels met een samenvatting en de populairste titels.
get_book_facts (id, language): de leesgegevens van één titel: niveau, lengte, leestijd bij drie leestempo’s, aantal pagina’s, luisterduur en het jaar van eerste publicatie.
get_themes (id, language): de studiegids bij één titel: thema’s, symbolen, tijd en plaats en motieven, met het adres van de volledige gids.
get_chapter_summary (id, language, chapter): de samenvatting van één hoofdstuk, bedrijf of scène, of de hoofdstukkenlijst als er geen hoofdstuk is opgegeven.
find_quote_source (quote, language): de toegankelijke tekst, het hoofdstuk en de alinea waaruit een citaat van minstens zes woorden afkomstig is. De tool noemt vindplaatsen en geeft nooit de woorden uit een boek terug.
explain_phrase (phrase, language): wat een gezegde of uitdrukking betekent, waar die vandaan komt en in welke titels die voorkomt.
recommend_classics (query, language, level, free_only, limit): wat je hierna kunt lezen, op basis van een titel die je goed vond, een onderwerp of een stemming.

Bij een samenvatting, een voorbeeldpagina of een hoofdstuk op de gratis boekenplank dat nog niet toegankelijk is (een titel, een taal of alle teksten voordat ze online komen), krijg je duidelijk te horen dat het hier binnenkort beschikbaar komt. Daarna verschijnt de inhoud zonder dat je iets hoeft aan te passen. Er is geen tool die een heel boek teruggeeft: de tools geven kleine, beperkte fragmenten terug en tellen per client hoeveel woorden ze verstrekken (72.000 per dag en 48.000 per uur; het antwoord toont hoeveel er over zijn).

Een assistent verbinden

Alle zesentwintig tools lezen alleen gegevens, dus elke client kan ze toestaan zonder telkens om toestemming te vragen. Het adres is https://mcp.libraryofalexandria.com/mcp (voeg ?toolset=catalogue,study,orders toe of gebruik https://api.libraryofalexandria.com/mcp voor alleen de negentien openbare tools).

Claude: Instellingen, Connectoren, Aangepaste connector toevoegen. In Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: open chatgpt.com/plugins, kies de plusknop en Aangepaste MCP-server toevoegen, voer het adres in en maak de plug-in aan.
Cursor: voeg "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} toe onder mcpServers in ~/.cursor/mcp.json.
VS Code: voer MCP: Server toevoegen uit vanuit het opdrachtenpalet, kies HTTP en voer het adres in.
LM Studio (0.3.17 of nieuwer): tabblad Programma, Installeren, mcp.json bewerken, voeg vervolgens dezelfde url-vermelding toe onder mcpServers.
Open WebUI (0.6.31 of nieuwer): Instellingen, Beheer, Integraties, Externe toolservers, Verbinding toevoegen, type MCP (Streamable HTTP), het adres, geen authenticatie. Of kies het type OpenAPI en voer het adres van het OpenAPI-bestand in.
OpenAI Responses API: geef {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} mee in tools.

Kleine lokale modellen werken het best met een korte lijst tools: verbind alleen de tools die de taak nodig heeft.

Je eigen bibliotheek (zeven tools, met je toestemming)

Iemand met een account op libraryofalexandria.com kan de eigen assistent toegang geven tot de eigen bibliotheek en praten over het boek dat diegene leest. De assistent vraagt eenmalig toestemming; de persoon keurt dit goed op libraryofalexandria.com en kan de verbinding op elk moment verbreken op de pagina met verbonden assistenten.

get_my_plan: het abonnement, de status ervan en hoeveel woorden tekst er vandaag nog beschikbaar zijn.
list_my_library: de boeken in de bibliotheek, per status (wil lezen, aan het lezen, uitgelezen, gepauzeerd, gestopt).
get_book_outline: de hoofdstukken van een boek en welke gratis, open of vergrendeld zijn. Geen tekst.
get_listen_link: het adres van de luisterpagina van een boek of hoofdstuk.
open_in_reader: het adres van een hoofdstuk (en alinea) in de lezer.
search_in_book: zoeken op trefwoord in de open hoofdstukken van één boek: korte fragmenten met een locatieaanduiding.
get_passage: één passage op basis van een locatieaanduiding, maximaal 400 woorden, met een bronverwijzing en een adres.

Tekst komt alleen uit boeken waarvan de tekst open is en uit hoofdstukken die de persoon mag lezen, maximaal 400 woorden per keer. De verbinding gebruikt OAuth 2.1 met PKCE: de documenten staan op /.well-known/oauth-protected-resource/mcp en /.well-known/oauth-authorization-server; een aanroep zonder token krijgt als antwoord 401 met een WWW-Authenticate-header die daarnaar verwijst. Een assistent registreert zich met een Client ID Metadata Document of POST /oauth/register (vijf nieuwe clients per uur vanaf één adres).

De REST API aanroepen

Elke tool is één bewerking, POST /v1/<tool>, met de argumenten van de tool als JSON-object en zonder sleutel.

// JavaScript (Node 18 of nieuwer, browsers, Deno, Bun, Workers)
const res = await fetch("https://api.libraryofalexandria.com/v1/get_book", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ id: "top3500-00002", language: "en" }),
});
const { ok, data } = await res.json();
console.log(data.title, data.url);

# Python, alleen de standaardbibliotheek
import json, urllib.request

req = urllib.request.Request(
    "https://api.libraryofalexandria.com/v1/list_free_shelf",
    data=json.dumps({"language": "es", "limit": 5}).encode(),
    headers={"content-type": "application/json"},
)
print(json.load(urllib.request.urlopen(req))["data"]["titles"])

Het OpenAPI-bestand en de toolbestanden

Het OpenAPI 3.1-bestand op /v1/openapi.json beschrijft elke bewerking, de argumenten en de structuur van het antwoord. Importeer het in Open WebUI, Dify, Flowise, Copilot Studio of een andere OpenAPI-tool. Voor programma’s die tooldefinities aan een model doorgeven, geeft GET /v1/tools?format= de tools terug in de structuur die elke aanbieder verwacht (voeg &toolset=catalogue,study,orders toe voor alleen de negentien openbare tools): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama en mcp (de lijst die de MCP-server toont). Beantwoord de aanroepen van het model met de bovenstaande REST-bewerkingen.

Fouten

Een probleem wordt teruggegeven als application/problem+json (RFC 9457) met type, title, status, detail en een vaste code.

400 invalid_json, invalid_request, unknown_format: de body is geen JSON, een argument ontbreekt of is onjuist (de toelichting vermeldt welk argument), of het formaat van het toolbestand is onbekend.
404 unknown_tool, not_found: deze tool of titel bestaat niet.
405 method_not_allowed: tools gebruiken POST; documenten gebruiken GET.
413 payload_too_large: de body is groter dan 8 KB.
415 unsupported_media_type: een body moet JSON zijn.
500 internal: de bibliotheek kon zojuist niet antwoorden. Probeer het zo nog eens.

De antwoorden gebruiken

Geef weer wat het antwoord zegt en gebruik de url van een titel zoals die is opgegeven. Verzin geen prijs of aanbieding.
De bibliotheek is niet de oude bibliotheek van Alexandrië en niet de Bibliotheca Alexandrina.
Betalen en aanmelden kan alleen op libraryofalexandria.com. Een tool kan een link geven, maar verwerkt nooit een betaling.
Je hebt geen sleutel nodig. Beperk je tot enkele verzoeken per seconde en stuur een User-Agent mee die je programma vermeldt.

Voorwaarden voor ontwikkelaars

De openbare tools zijn gratis te gebruiken zonder sleutel, binnen de limieten op deze pagina. Een ontwikkelaarssleutel, aangemaakt door iemand die is ingelogd op libraryofalexandria.com, verhoogt de limieten en toont je gebruik; het gratis plan biedt 60 aanroepen per minuut en 1.000 aanroepen per kalendermaand voor het account, ongeacht het aantal sleutels.
Gebruik de antwoorden om iemand te helpen boeken te vinden, te lezen en te bestellen. Geef weer wat een antwoord zegt, behoud de link naar onze pagina en presenteer onze samenvattingen, studiegidsen of teksten niet als je eigen werk.
Kopieer onze teksten, samenvattingen of studiegidsen niet in grote hoeveelheden, sla ze niet op om er antwoorden op te baseren, verkoop ze niet door en train er geen model mee. Daarvoor heb je een schriftelijke licentie nodig: zie AI- en datalicenties.
Probeer geen limiet te omzeilen, deel geen sleutel en roep de tools niet aan op een manier die ze voor anderen vertraagt. We kunnen de toegang van een sleutel of adres dat dit doet vertragen, beperken of beëindigen. De eigenaar kan een sleutel op elk moment intrekken.
De tools worden aangeboden zoals ze zijn. We houden ze werkend en kunnen een tool wijzigen of buiten gebruik stellen; wijzigingen worden op deze pagina aangekondigd.

Privacy

De dienst telt aanroepen per toolnaam, status en de naam en versie van de client. De dienst bewaart niet wat er is gevraagd en plaatst geen cookies. Het privacybeleid en de gebruiksvoorwaarden zijn van toepassing.

Versies

De API-versie is een datum die wordt teruggestuurd in de LOA-Version-header (nu 2026-10-25). Wijzigingen worden op deze pagina aangekondigd.