Utviklere

Bibliotekets katalog, gratisavdelingen og trykte utgaver er tilgjengelige for programmer, assistenter og modeller som nitten offentlige skrivebeskyttede verktøy. Du trenger ingen nøkkel og trenger ikke registrere deg. Sju verktøy til kan lese en persons eget bibliotek når personen har koblet kontoen sin til assistenten sin (se Ditt eget bibliotek). Verktøyene logger aldri noen inn, krever aldri betaling og endrer aldri noe: Hver tittel returneres med adressen til siden sin på libraryofalexandria.com, der man kan lese, lytte, skrive ut eller begynne.

Tre innganger

MCP (Streamable HTTP) på https://mcp.libraryofalexandria.com/mcp: for Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose og alle andre MCP-klienter.
REST og OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> og OpenAPI-filen på https://api.libraryofalexandria.com/v1/openapi.json: for skript, automatiseringsverktøy (n8n, Zapier, Make, Dify, Flowise), verktøytjenere for Open WebUI og Copilot Studio.
Verktøyfiler for modellutviklere: GET https://api.libraryofalexandria.com/v1/tools?format=openai: for alle programmer som sender verktøydefinisjoner til en modell. Formatene er openai, openai-chat, anthropic, gemini, ollama og mcp.

Prøv på ett minutt

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

Svaret er {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Hver tittel i data.results har en id, en title, en author og url-en til siden sin.

De nitten verktøyene

Åtte slår opp titler, ett viser trykte utgaver, fire klargjør et personlig trykk, og seks hjelper med studier og valg. Velg hvilke verktøy assistenten skal se, med ?toolset= på MCP-adressen. En kort liste passer for små lokale modeller:

https://api.libraryofalexandria.com/mcp: de nitten offentlige verktøyene, ingen innlogging (adressen i katalogoppføringene våre).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: de samme nitten offentlige verktøyene.
?toolset=catalogue,orders: de tretten verktøyene som slår opp titler, viser trykte utgaver og klargjør et personlig trykk.
?toolset=study: de seks studieverktøyene.
https://mcp.libraryofalexandria.com/mcp uten toolset: de nitten offentlige verktøyene og de sju verktøyene for en persons eget bibliotek, til sammen tjueseks. De sju svarer bare med personens tillatelse.

search_books (query, language, limit): finn titler ved å søke på ord fra en tittel, en forfatter eller et emne, på alle språk i katalogen.
get_book (id, language): fakta om én tittel: forfatter, originaltittel, omslag, trykte utgaver og siden på hvert språk.
get_summary (id, language, part): den første hovedideen i sammendraget på 15 minutter av én tittel, i sin helhet, og overskriftene til de øvrige.
get_sample (id, language, page): en gratis smakebit fra starten av én tittel, i sider på maks 400 ord.
list_free_shelf (language, subject, limit): titlene i gratisavdelingen, etter språk og emne.
read_free_chapter (id, chapter, page, language): ett kapittel fra en tittel i gratisavdelingen, i sider på maks 400 ord.
get_print_options (id, language): trykte utgaver av én tittel (standard og stor skrift, paperback eller innbundet), med prisen på hver i amerikanske dollar.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): prisen på et trykt eksemplar av én tittel med en personlig meldingsside, totalprisen for antallet eksemplarer og siden der meldingen skrives og bestillingen legges inn.
get_cover_upload_link (id, language): siden der man kan legge til sitt eget omslagsbilde på et trykt eksemplar.
create_custom_print_order (quote_id): siden der man skriver meldingen, ser korrekturen og betaler. Ingen bestilling eller betaling skjer via assistenten.
get_order_status (order_ref, email, language): status for en trykt bestilling.
get_publisher_info: hvem som utgir biblioteket, språkene, vilkårene og personvernsiden.
browse_collection (collection, language, limit, cursor): en ferdig samling med åtte titler om gangen: gratisbøker, lett, middels eller krevende nivå, glemte bøker, titler med sammendrag og de mest populære.
get_book_facts (id, language): leseinformasjon om én tittel: nivå, lengde, lesetid i tre tempoer, sider, lydlengde og året den først ble utgitt.
get_themes (id, language): studieveiledningen til én tittel: temaer, symboler, miljø og motiver, med adressen til hele veiledningen.
get_chapter_summary (id, language, chapter): sammendraget av ett kapittel, én akt eller én scene, eller listen over kapitler hvis ingen kapittel er angitt.
find_quote_source (quote, language): den fritt tilgjengelige teksten, kapitlet og avsnittet som et sitat på minst seks ord kommer fra. Verktøyet oppgir hvor det finnes, men returnerer aldri tekst fra en bok.
explain_phrase (phrase, language): hva et uttrykk eller idiom betyr, hvor det kommer fra, og hvilke titler som bruker det.
recommend_classics (query, language, level, free_only, limit): forslag til hva du kan lese videre, basert på en tittel personen likte, eller et emne eller en stemning.

Hvis et sammendrag, en smakebit eller et kapittel fra gratisavdelingen ikke er tilgjengelig ennå (for en tittel, et språk eller alle tekster før de legges ut), får man et tydelig svar om at det snart blir tilgjengelig her. Deretter fylles innholdet ut automatisk, uten at du trenger å gjøre noe. Ingen verktøy returnerer en hel bok: Verktøyene gir korte, begrensede utdrag og teller ordene de leverer til hver klient (72 000 per dag og 48 000 per time; svaret viser hvor mye som gjenstår).

Koble til en assistent

Alle tjueseks verktøyene er skrivebeskyttede, så klienter kan få tilgang til dem uten å spørre hver gang. Adressen er https://mcp.libraryofalexandria.com/mcp (legg til ?toolset=catalogue,study,orders, eller bruk https://api.libraryofalexandria.com/mcp, for bare de nitten offentlige verktøyene).

Claude: Settings, Connectors, Add custom connector. I Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: åpne chatgpt.com/plugins, velg plusstegnet og Add custom MCP server, skriv inn adressen og opprett pluginen.
Cursor: legg til "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} under mcpServers i ~/.cursor/mcp.json.
VS Code: kjør MCP: Add Server fra kommandopaletten, velg HTTP og skriv inn adressen.
LM Studio (0.3.17 eller nyere): Program-fanen, Install, Edit mcp.json, og legg deretter til den samme url-oppføringen under mcpServers.
Open WebUI (0.6.31 eller nyere): Settings, Admin, Integrations, External Tool Servers, Add Connection, velg MCP (Streamable HTTP), skriv inn adressen og velg ingen autentisering. Eller velg OpenAPI-typen og skriv inn adressen til OpenAPI-filen.
OpenAI Responses API: send {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} i tools.

Små lokale modeller fungerer best med en kort verktøyliste: Koble bare til verktøyene oppgaven trenger.

Ditt eget bibliotek (sju verktøy, med din tillatelse)

En person med en konto på libraryofalexandria.com kan la sin egen assistent se i biblioteket sitt og snakke om boka personen leser. Assistenten spør én gang; personen godkjenner på libraryofalexandria.com og kan når som helst koble den fra på siden for tilkoblede assistenter.

get_my_plan: abonnementet, statusen og hvor mange ord tekst det er igjen for i dag.
list_my_library: bøkene i biblioteket, etter status (ønsker å lese, leser, ferdig, satt på pause, avbrutt).
get_book_outline: kapitlene i en bok, og hvilke som er gratis, åpne eller låste. Ingen tekst.
get_listen_link: adressen til lyttesiden for en bok eller et kapittel.
open_in_reader: adressen til et kapittel (og avsnitt) i leseren.
search_in_book: søk etter nøkkelord i de åpne kapitlene i én bok: korte utdrag med en henvisning.
get_passage: én tekstpassasje fra en henvisning, maks. 400 ord, med kildehenvisning og adresse.

Tekst hentes bare fra bøker med åpen tekst og fra kapitler personen har tilgang til å lese, maks. 400 ord om gangen. Tilkoblingen bruker OAuth 2.1 med PKCE: dokumentene finnes på /.well-known/oauth-protected-resource/mcp og /.well-known/oauth-authorization-server; et kall uten token gir svaret 401 med en WWW-Authenticate-header som viser til disse. En assistent registrerer seg med et Client ID Metadata Document eller POST /oauth/register (fem nye klienter i timen fra én adresse).

Kall REST API-et

Hvert verktøy er én operasjon, POST /v1/<tool>, med verktøyets argumenter som et JSON-objekt og uten nøkkel.

// JavaScript (Node 18 eller nyere, nettlesere, 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, kun standardbiblioteket
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"])

OpenAPI-filen og verktøyfilene

OpenAPI 3.1-filen på /v1/openapi.json beskriver hver operasjon, argumentene og formen på svaret. Importer den i Open WebUI, Dify, Flowise, Copilot Studio eller et hvilket som helst OpenAPI-verktøy. For programmer som sender verktøydefinisjoner til en modell, returnerer GET /v1/tools?format= verktøyene i formatet hver leverandør forventer (legg til &toolset=catalogue,study,orders for bare de nitten offentlige verktøyene): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama og mcp (listen MCP-serveren viser). Besvar kallene modellen gjør med REST-operasjonene ovenfor.

Feil

En feil returneres som application/problem+json (RFC 9457) med type, title, status, detail og en stabil code.

400 invalid_json, invalid_request, unknown_format: Innholdet er ikke JSON, et argument mangler eller er feil (detaljene angir hvilket), eller formatet på verktøyfilen er ukjent.
404 unknown_tool, not_found: Verktøyet eller tittelen finnes ikke.
405 method_not_allowed: Verktøyene bruker POST; dokumentene bruker GET.
413 payload_too_large: Innholdet er på over 8 KB.
415 unsupported_media_type: Innholdet må være JSON.
500 internal: Biblioteket kunne ikke svare akkurat nå. Prøv igjen om litt.

Slik bruker du svarene

Gjengi det svaret sier, og bruk url for en tittel slik den er oppgitt. Ikke finn på en pris eller et tilbud.
Biblioteket er ikke det antikke biblioteket i Alexandria og heller ikke Bibliotheca Alexandrina.
Betaling og registrering skjer bare på libraryofalexandria.com. Et verktøy kan sende videre en lenke; det tar aldri imot betaling.
Du trenger ingen nøkkel. Hold deg til noen få forespørsler i sekundet, og send en User-Agent som oppgir navnet på programmet ditt.

Vilkår for utviklere

De offentlige verktøyene kan brukes uten nøkkel, innenfor grensene på denne siden. En utviklernøkkel, opprettet av en person som er logget inn på libraryofalexandria.com, øker grensene og viser bruken din. Gratisabonnementet tillater 60 kall i minuttet og 1 000 kall per kalendermåned for kontoen, uansett hvor mange nøkler den har.
Bruk svarene til å hjelpe noen med å finne, lese og bestille bøker. Gjengi det svaret sier, behold lenken til siden vår, og ikke framstill sammendragene, studieveiledningene eller tekstene våre som dine egne.
Ikke kopier tekstene, sammendragene eller studieveiledningene våre i stort omfang, lagre dem for å bruke dem som svargrunnlag, selg dem videre eller tren en modell på dem. Dette krever en skriftlig lisens: se AI- og datalisenser.
Ikke prøv å omgå en grense, del en nøkkel eller kall verktøyene på en måte som gjør dem tregere for andre. Vi kan redusere hastigheten, begrense eller avslutte tilgangen for en nøkkel eller adresse som gjør dette. Eieren kan når som helst tilbakekalle en nøkkel.
Verktøyene leveres som de er. Vi sørger for at de fungerer, og kan endre eller avvikle et verktøy. Endringer kunngjøres på denne siden.

Personvern

Tjenesten teller kall etter verktøynavn, status samt klientens navn og versjon. Den lagrer ikke hva det ble spurt om, og bruker ingen informasjonskapsler. Personvernerklæringen og tjenestevilkårene gjelder.

Versjoner

API-versjonen er en dato som sendes tilbake i LOA-Version-headeren (nå 2026-10-25). Endringer kunngjøres på denne siden.