Dezvoltatori

Catalogul bibliotecii, raftul cu cărți gratuite și edițiile tipărite sunt disponibile programelor, asistenților și modelelor prin intermediul a nouăsprezece instrumente publice, doar pentru citire. Nu este nevoie de cheie și nici de înregistrare. Alte șapte instrumente accesează biblioteca personală a cuiva, după ce persoana își conectează contul la asistent (vezi Biblioteca ta). Instrumentele nu autentifică pe nimeni, nu încasează plăți și nu modifică nimic: fiecare titlu este însoțit de adresa paginii sale de pe libraryofalexandria.com, unde poate fi citit, ascultat, tipărit sau accesat.

Trei modalități de acces

MCP (Streamable HTTP) la https://mcp.libraryofalexandria.com/mcp: pentru Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose și orice alt client MCP.
REST și OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> și fișierul OpenAPI la https://api.libraryofalexandria.com/v1/openapi.json: pentru scripturi, instrumente de automatizare (n8n, Zapier, Make, Dify, Flowise), servere de instrumente Open WebUI și Copilot Studio.
Fișiere cu instrumente pentru creatorii de modele: GET https://api.libraryofalexandria.com/v1/tools?format=openai: pentru orice program care transmite definiții de instrumente unui model. Formatele sunt openai, openai-chat, anthropic, gemini, ollama și mcp.

Încearcă în mai puțin de un minut

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

Răspunsul este {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Fiecare titlu din data.results are un id, un title, un author și adresa url a paginii sale.

Cele nouăsprezece instrumente

Opt caută un titlu, unul afișează edițiile tipărite, patru pregătesc un exemplar tipărit personalizat, iar șase ajută la studiu și la alegerea lecturii. Alege instrumentele disponibile pentru un asistent adăugând ?toolset= la adresa MCP; o listă scurtă este potrivită pentru modelele locale mici:

https://api.libraryofalexandria.com/mcp: cele nouăsprezece instrumente publice, fără autentificare (adresa pentru listările din directorul nostru).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: aceleași nouăsprezece instrumente publice.
?toolset=catalogue,orders: cele treisprezece instrumente care caută un titlu, îi afișează edițiile tipărite și pregătesc un exemplar tipărit personalizat.
?toolset=study: cele șase instrumente de studiu.
https://mcp.libraryofalexandria.com/mcp fără toolset: cele nouăsprezece instrumente publice și cele șapte instrumente ale bibliotecii personale, douăzeci și șase în total; cele șapte răspund doar cu permisiunea persoanei.

search_books (query, language, limit): găsește titluri folosind cuvinte din titlu, numele unui autor sau o temă, în orice limbă din catalog.
get_book (id, language): informații despre un titlu: autor, titlu original, copertă, ediții tipărite și pagina sa în fiecare limbă.
get_summary (id, language, part): prima idee-cheie din rezumatul de 15 minute al unui titlu, integral, și titlurile celorlalte secțiuni.
get_sample (id, language, page): începutul gratuit al unui titlu, în pagini de cel mult 400 de cuvinte.
list_free_shelf (language, subject, limit): titlurile de pe raftul cu cărți gratuite, în funcție de limbă și subiect.
read_free_chapter (id, chapter, page, language): un capitol dintr-un titlu de pe raftul cu cărți gratuite, în pagini de cel mult 400 de cuvinte.
get_print_options (id, language): edițiile tipărite ale unui titlu (format standard sau cu caractere mari, broșat sau cartonat), cu prețul fiecăreia în dolari americani.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): prețul unui exemplar tipărit dintr-un titlu, cu pagină pentru mesaj personal, totalul pentru numărul de exemplare și pagina unde se scrie mesajul și se plasează comanda.
get_cover_upload_link (id, language): pagina unde se poate adăuga propria imagine de copertă pentru un exemplar tipărit.
create_custom_print_order (quote_id): pagina unde persoana scrie mesajul, verifică proba și plătește. Asistentul nu plasează și nu achită nicio comandă.
get_order_status (order_ref, email, language): stadiul unei comenzi tipărite.
get_publisher_info: cine publică biblioteca, limbile disponibile, condițiile și pagina de confidențialitate.
browse_collection (collection, language, limit, cursor): un raft pregătit, cu opt titluri odată: cărțile gratuite, cele ușoare, medii sau dificile, cărțile pierdute, titlurile cu rezumat și cele mai populare.
get_book_facts (id, language): informații despre lectură pentru un titlu: nivel, lungime, timp de lectură în trei ritmuri, număr de pagini, durata audio și anul primei publicări.
get_themes (id, language): ghidul de studiu pentru un titlu: teme, simboluri, cadru și motive recurente, cu adresa ghidului complet.
get_chapter_summary (id, language, chapter): rezumatul unui capitol, act sau scene, ori lista capitolelor dacă nu este indicat niciunul.
find_quote_source (quote, language): textul disponibil public, capitolul și paragraful din care provine un citat de cel puțin șase cuvinte. Indică locurile, dar nu redă cuvintele unei cărți.
explain_phrase (phrase, language): sensul unei zicale sau expresii, originea sa și titlurile în care apare.
recommend_classics (query, language, level, free_only, limit): ce să citești în continuare, pornind de la un titlu care i-a plăcut persoanei sau de la o temă ori dispoziție.

Dacă rezumatul, pagina de mostră sau capitolul de pe raftul cu cărți gratuite nu este încă disponibil (un titlu, o limbă sau toate textele înainte de publicare), răspunsul spune clar că va fi disponibil aici în curând. Apoi va apărea fără să fie nevoie de vreo acțiune din partea ta. Niciun instrument nu returnează o carte întreagă: instrumentele furnizează fragmente mici, limitate, și țin evidența cuvintelor oferite fiecărui client (72.000 pe zi și 48.000 pe oră; răspunsul indică numărul rămas).

Conectează un asistent

Toate cele douăzeci și șase de instrumente doar citesc, așa că orice client le poate permite fără să ceară confirmare de fiecare dată. Adresa este https://mcp.libraryofalexandria.com/mcp (adaugă ?toolset=catalogue,study,orders sau folosește https://api.libraryofalexandria.com/mcp pentru acces doar la cele nouăsprezece instrumente publice).

Claude: Settings, Connectors, Add custom connector. În Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: accesează chatgpt.com/plugins, alege butonul cu semnul plus și Add custom MCP server, introdu adresa și creează pluginul.
Cursor: adaugă "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} sub mcpServers în ~/.cursor/mcp.json.
VS Code: rulează MCP: Add Server din Command Palette, alege HTTP și introdu adresa.
LM Studio (0.3.17 sau mai nou): fila Program, Install, Edit mcp.json, apoi adaugă aceeași intrare url sub mcpServers.
Open WebUI (0.6.31 sau mai nou): Settings, Admin, Integrations, External Tool Servers, Add Connection, selectează MCP (Streamable HTTP), introdu adresa și nu alege autentificarea. Sau selectează tipul OpenAPI și introdu adresa fișierului OpenAPI.
OpenAI Responses API: trimite {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} în tools.

Modelele locale mici funcționează cel mai bine cu o listă scurtă de instrumente: conectează doar instrumentele de care are nevoie sarcina.

Biblioteca ta (șapte instrumente, cu permisiunea ta)

O persoană cu un cont pe libraryofalexandria.com își poate lăsa propriul asistent să consulte biblioteca și să discute despre cartea pe care o citește. Asistentul cere permisiunea o singură dată; persoana o aprobă pe libraryofalexandria.com și o poate revoca oricând din pagina asistenților conectați.

get_my_plan: abonamentul, starea lui și numărul de cuvinte de text care au rămas pentru astăzi.
list_my_library: cărțile din bibliotecă, în funcție de stare (de citit, în curs de citire, terminate, în pauză, abandonate).
get_book_outline: capitolele unei cărți și care sunt gratuite, deschise sau blocate. Fără text.
get_listen_link: adresa paginii de ascultare a unei cărți sau a unui capitol.
open_in_reader: adresa unui capitol (și a unui paragraf) în cititor.
search_in_book: căutare după cuvânt-cheie în capitolele deschise ale unei cărți: fragmente scurte cu un locator.
get_passage: un fragment identificat prin locator, de cel mult 400 de cuvinte, cu citare și adresă.

Textul provine doar din cărți al căror text este deschis și din capitole pe care persoana le poate citi, în fragmente de cel mult 400 de cuvinte. Conexiunea folosește OAuth 2.1 cu PKCE: documentele se găsesc la /.well-known/oauth-protected-resource/mcp și /.well-known/oauth-authorization-server; un apel fără token răspunde cu 401 și un antet WWW-Authenticate care indică aceste adrese. Asistentul se înregistrează folosind un Client ID Metadata Document sau POST /oauth/register (cinci clienți noi pe oră de la aceeași adresă).

Apelează REST API-ul

Fiecare instrument corespunde unei singure operațiuni, POST /v1/<tool>, cu argumentele instrumentului sub forma unui obiect JSON și fără cheie.

// JavaScript (Node 18 sau mai nou, browsere, 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, doar biblioteca standard
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"])

Fișierul OpenAPI și fișierele instrumentelor

Fișierul OpenAPI 3.1 de la /v1/openapi.json descrie fiecare operațiune, argumentele și structura răspunsului. Importă-l în Open WebUI, Dify, Flowise, Copilot Studio sau orice instrument OpenAPI. Pentru programele care transmit definițiile instrumentelor unui model, GET /v1/tools?format= returnează instrumentele în formatul dorit de fiecare creator (adaugă &toolset=catalogue,study,orders pentru doar cele nouăsprezece instrumente publice): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama și mcp (lista afișată de serverul MCP). Răspunde apelurilor făcute de model folosind operațiunile REST de mai sus.

Erori

O problemă este returnată ca application/problem+json (RFC 9457), cu type, title, status, detail și un code stabil.

400 invalid_json, invalid_request, unknown_format: corpul nu este JSON, lipsește un argument sau este incorect (detaliile indică despre care este vorba) ori formatul fișierului instrumentului este necunoscut.
404 unknown_tool, not_found: instrumentul sau titlul respectiv nu există.
405 method_not_allowed: instrumentele acceptă POST; documentele acceptă GET.
413 payload_too_large: corpul depășește 8 KB.
415 unsupported_media_type: corpul trebuie să fie JSON.
500 internal: biblioteca nu a putut răspunde acum. Încearcă din nou în câteva momente.

Folosirea răspunsurilor

Redă informațiile din răspuns și folosește adresa url a unui titlu exact așa cum este furnizată. Nu inventa prețuri sau oferte.
Biblioteca nu este biblioteca antică din Alexandria și nici Bibliotheca Alexandrina.
Plățile și înscrierea se fac doar pe libraryofalexandria.com. Un instrument poate furniza un link; nu încasează niciodată plăți.
Nu este nevoie de cheie. Te rugăm să nu trimiți mai mult de câteva solicitări pe secundă și să incluzi un User-Agent care identifică programul tău.

Condiții pentru dezvoltatori

Instrumentele publice pot fi folosite fără cheie, în limitele indicate pe această pagină. O cheie de dezvoltator, creată de o persoană conectată la libraryofalexandria.com, mărește limitele și afișează utilizarea; planul fără cost include 60 de apeluri pe minut și 1.000 de apeluri într-o lună calendaristică pentru cont, indiferent de numărul de chei.
Folosește răspunsurile pentru a ajuta oamenii să descopere, să citească și să comande cărți. Redă informațiile din răspuns, păstrează linkul către pagina noastră și nu prezenta rezumatele, ghidurile de studiu sau textele noastre ca fiind ale tale.
Nu copia în bloc textele, rezumatele sau ghidurile noastre de studiu, nu le păstra într-o arhivă pentru a le folosi la generarea răspunsurilor, nu le revinde și nu antrena modele pe baza lor. Pentru asta este nevoie de o licență scrisă: consultă Licențe pentru IA și date.
Nu încerca să ocolești o limită, să partajezi o cheie sau să apelezi instrumentele într-un mod care le încetinește pentru ceilalți. Putem încetini, limita sau întrerupe accesul unei chei sau al unei adrese care face asta, iar proprietarul poate revoca oricând o cheie.
Instrumentele sunt furnizate ca atare. Le menținem funcționale și putem modifica sau retrage un instrument; modificările sunt anunțate pe această pagină.

Confidențialitate

Serviciul contabilizează apelurile după numele instrumentului, stare, precum și numele și versiunea clientului. Nu păstrează solicitările și nu folosește cookie-uri. Se aplică politica de confidențialitate și condițiile de utilizare.

Versiuni

Versiunea API-ului este o dată, transmisă în antetul LOA-Version (acum 2026-10-25). Modificările sunt anunțate pe această pagină.