Utvecklare

Bibliotekets katalog, dess gratis hylla och dess tryckta utgåvor är tillgängliga för program, assistenter och modeller via nitton offentliga verktyg med enbart läsbehörighet. Ingen nyckel behövs och du behöver inte registrera dig. Sju verktyg till läser i en persons eget bibliotek, när personen har kopplat sitt konto till sin assistent (se Ditt eget bibliotek). Verktygen loggar aldrig in någon, tar inte emot betalningar och ändrar ingenting: varje titel kommer med adressen till sin sida på libraryofalexandria.com, där man kan läsa, lyssna, skriva ut eller sätta igång.

Tre sätt att komma åt verktygen

MCP (Streamable HTTP) på https://mcp.libraryofalexandria.com/mcp: för Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose och alla andra MCP-klienter.
REST och OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> och OpenAPI-filen på https://api.libraryofalexandria.com/v1/openapi.json: för skript, automationsverktyg (n8n, Zapier, Make, Dify, Flowise), verktygsservrar för Open WebUI och Copilot Studio.
Verktygsfiler för modellutvecklare: GET https://api.libraryofalexandria.com/v1/tools?format=openai: för alla program som skickar verktygsdefinitioner till en modell. Formaten är openai, openai-chat, anthropic, gemini, ollama och mcp.

Testa på en minut

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

Svaret är {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Varje titel i data.results har ett id, en title, en author och sidans url.

De nitton verktygen

Åtta söker upp en titel, ett visar de tryckta utgåvorna, fyra förbereder en personlig tryckt kopia och sex hjälper till med studier och val. Välj vilka verktyg en assistent ser genom att lägga till ?toolset= på MCP-adressen; en kort lista passar små lokala modeller:

https://api.libraryofalexandria.com/mcp: de nitton offentliga verktygen, ingen inloggning (adressen för våra kataloglistningar).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: samma nitton offentliga verktyg.
?toolset=catalogue,orders: de tretton verktyg som söker upp en titel, visar dess tryckta utgåvor och förbereder en personlig tryckt kopia.
?toolset=study: de sex studieverktygen.
https://mcp.libraryofalexandria.com/mcp utan toolset: de nitton offentliga verktygen och de sju verktygen i en persons eget bibliotek, tjugosex sammanlagt; de sju svarar bara med personens tillåtelse.

search_books (query, language, limit): hitta titlar genom ord från en titel, en författare eller ett ämne, på alla språk i katalogen.
get_book (id, language): fakta om en titel: författare, originaltitel, omslag, tryckta utgåvor och dess sida på varje språk.
get_summary (id, language, part): den första nyckelidén i sammanfattningen på 15 minuter av en titel i sin helhet, samt rubrikerna för de övriga.
get_sample (id, language, page): ett gratis utdrag ur början av en titel, uppdelat i sidor på högst 400 ord.
list_free_shelf (language, subject, limit): titlarna på gratis hyllan, efter språk och ämne.
read_free_chapter (id, chapter, page, language): ett kapitel ur en titel på gratis hyllan, uppdelat i sidor på högst 400 ord.
get_print_options (id, language): de tryckta utgåvorna av en titel (standard och stor stil, pocket eller inbunden) med priset för varje i amerikanska dollar.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): priset för ett tryckt exemplar av en titel med en personlig meddelandesida, totalpriset för antalet exemplar samt sidan där meddelandet skrivs och beställningen görs.
get_cover_upload_link (id, language): sidan där man lägger till sin egen omslagsbild till ett tryckt exemplar.
create_custom_print_order (quote_id): sidan där personen skriver meddelandet, granskar korrekturet och betalar. Inget beställs eller betalas via assistenten.
get_order_status (order_ref, email, language): status för en tryckt beställning.
get_publisher_info: vem som ger ut biblioteket, dess språk, villkoren och integritetssidan.
browse_collection (collection, language, limit, cursor): en färdig hylla, åtta titlar åt gången: gratisböckerna, de lättlästa, medelsvåra eller utmanande titlarna, de bortglömda böckerna, titlarna med en sammanfattning och de populäraste.
get_book_facts (id, language): läsfakta om en titel: nivå, längd, lästid i tre tempon, sidantal, ljudlängd och året då den först publicerades.
get_themes (id, language): studiehandledningen för en titel: teman, symboler, miljö och motiv, med adressen till den fullständiga handledningen.
get_chapter_summary (id, language, chapter): sammanfattningen av ett kapitel, en akt eller en scen, eller listan över kapitel om inget kapitel anges.
find_quote_source (quote, language): den fritt tillgängliga text, det kapitel och det stycke som ett citat på minst sex ord kommer från. Verktyget anger var man hittar texten och återger aldrig orden ur en bok.
explain_phrase (phrase, language): vad ett talesätt eller idiom betyder, varifrån det kommer och vilka titlar som använder det.
recommend_classics (query, language, level, free_only, limit): förslag på nästa läsning, utifrån en titel personen gillat eller ett ämne eller en sinnesstämning.

Om en sammanfattning, provsida eller ett kapitel från gratis hyllan ännu inte är tillgängligt (en titel, ett språk eller alla texter innan de publiceras), får du ett tydligt besked om att det snart öppnar här. Innehållet fylls sedan i utan att du behöver göra något. Inget verktyg lämnar ut en hel bok: verktygen ger små, begränsade utdrag och räknar orden de lämnar ut för varje klient (72 000 per dag och 48 000 per timme; svaret visar hur många som återstår).

Anslut en assistent

Alla tjugosex verktyg har enbart läsbehörighet, så klienter kan tillåta dem utan att fråga varje gång. Adressen är https://mcp.libraryofalexandria.com/mcp (lägg till ?toolset=catalogue,study,orders eller använd https://api.libraryofalexandria.com/mcp om du bara vill ha de nitton offentliga verktygen).

Claude: Settings, Connectors, Add custom connector. I Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: gå till chatgpt.com/plugins, välj plusknappen och Add custom MCP server, ange adressen och skapa pluginen.
Cursor: lägg till "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} under mcpServers i ~/.cursor/mcp.json.
VS Code: kör MCP: Add Server från Command Palette, välj HTTP och ange adressen.
LM Studio (0.3.17 eller senare): fliken Program, Install, Edit mcp.json och lägg sedan till samma url-post under mcpServers.
Open WebUI (0.6.31 eller senare): Settings, Admin, Integrations, External Tool Servers, Add Connection, välj MCP (Streamable HTTP), ange adressen och välj ingen autentisering. Eller välj OpenAPI-typen och ange adressen till OpenAPI-filen.
OpenAI Responses API: ange {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} i tools.

Små lokala modeller fungerar bäst med en kort verktygslista: anslut bara de verktyg som uppgiften kräver.

Ditt eget bibliotek (sju verktyg, med ditt tillstånd)

Den som har ett konto på libraryofalexandria.com kan låta sin egen assistent titta i biblioteket och prata om boken hen läser. Assistenten frågar en gång; personen godkänner på libraryofalexandria.com och kan när som helst koppla från den på sidan med anslutna assistenter.

get_my_plan: abonnemanget, dess status och hur många ord text som återstår i dag.
list_my_library: böckerna i biblioteket, sorterade efter status (vill läsa, läser, utläst, pausad, avbruten).
get_book_outline: bokens kapitel och vilka som är öppna eller låsta. Ingen text.
get_listen_link: adressen till lyssningssidan för en bok eller ett kapitel.
open_in_reader: adressen till ett kapitel (och stycke) i läsaren.
search_in_book: sökordssökning i en boks öppna kapitel: korta utdrag med en platsangivelse.
get_passage: ett textavsnitt från en platsangivelse, högst 400 ord, med en källhänvisning och en adress.

Text hämtas endast från böcker vars text är öppen och kapitel som personen får läsa, högst 400 ord åt gången. Anslutningen använder OAuth 2.1 med PKCE: dokumenten finns på /.well-known/oauth-protected-resource/mcp och /.well-known/oauth-authorization-server; ett anrop utan token ger svaret 401 med en WWW-Authenticate-header som hänvisar dit. En assistent registrerar sig med ett Client ID Metadata Document eller POST /oauth/register (fem nya klienter i timmen från en adress).

Anropa REST API:t

Varje verktyg är en operation, POST /v1/<tool>, med verktygets argument som ett JSON-objekt och utan nyckel.

// JavaScript (Node 18 eller senare, webbläsare, 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, endast 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 och verktygsfilerna

OpenAPI 3.1-filen på /v1/openapi.json beskriver varje operation, dess argument och hur svaret är utformat. Importera den till Open WebUI, Dify, Flowise, Copilot Studio eller valfritt OpenAPI-verktyg. För program som skickar verktygsdefinitioner till en modell returnerar GET /v1/tools?format= verktygen i det format som respektive leverantör använder (lägg till &toolset=catalogue,study,orders för enbart de nitton offentliga verktygen): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama och mcp (listan som MCP-servern visar). Besvara modellens anrop med REST-operationerna ovan.

Fel

Problem returneras som application/problem+json (RFC 9457) med type, title, status, detail och en stabil code.

400 invalid_json, invalid_request, unknown_format: innehållet är inte JSON, ett argument saknas eller är felaktigt (detaljen anger vilket), eller så är verktygsfilens format okänt.
404 unknown_tool, not_found: verktyget eller titeln finns inte.
405 method_not_allowed: verktyg använder POST; dokument använder GET.
413 payload_too_large: innehållet är större än 8 KB.
415 unsupported_media_type: innehållet måste vara JSON.
500 internal: biblioteket kunde inte svara just nu. Försök igen om en liten stund.

Använda svaren

Säg vad svaret säger och använd titelns url precis som den anges. Hitta inte på ett pris eller ett erbjudande.
Biblioteket är inte det antika biblioteket i Alexandria och inte Bibliotheca Alexandrina.
Betalningar och registrering sker endast på libraryofalexandria.com. Ett verktyg kan ge en länk; det tar aldrig emot betalningar.
Ingen nyckel behövs. Håll dig till några få anrop per sekund och ange en User-Agent som namnger ditt program.

Villkor för utvecklare

De offentliga verktygen får användas utan nyckel inom gränserna på den här sidan. En utvecklarnyckel, som skapas av en person som är inloggad på libraryofalexandria.com, höjer gränserna och visar din användning; grundplanen tillåter 60 anrop i minuten och 1 000 anrop per kalendermånad för kontot, oavsett hur många nycklar det har.
Använd svaren för att hjälpa någon att hitta, läsa och beställa böcker. Återge vad svaret säger, behåll länken till vår sida och framställ inte våra sammanfattningar, studieguider eller texter som dina egna.
Kopiera inte våra texter, sammanfattningar eller studieguider i bulk, spara dem som en samling att hämta svar från, sälj dem vidare eller träna en modell på dem. Det kräver en skriftlig licens: se AI- och datalicenser.
Försök inte kringgå en gräns, dela en nyckel eller anropa verktygen på ett sätt som gör dem långsammare för andra. Vi kan begränsa eller avsluta åtkomsten för en nyckel eller adress som gör det, och ägaren kan när som helst återkalla en nyckel.
Verktygen tillhandahålls i befintligt skick. Vi håller dem igång och kan ändra eller ta bort ett verktyg; ändringar meddelas på den här sidan.

Integritet

Tjänsten räknar anrop efter verktygsnamn, status samt klientens namn och version. Den sparar inte vad som efterfrågats och använder inga cookies. Integritetspolicyn och användarvillkoren gäller.

Versioner

API-versionen är ett datum som skickas tillbaka i headern LOA-Version (nu 2026-10-25). Ändringar meddelas på den här sidan.