Desenvolvedores

O catálogo da biblioteca, sua estante gratuita e suas edições impressas estão disponíveis para programas, assistentes e modelos por meio de dezenove ferramentas públicas somente de leitura. Não é preciso ter uma chave nem se cadastrar. Outras sete ferramentas leem a biblioteca pessoal de alguém, depois que essa pessoa conecta sua conta ao assistente (veja Sua própria biblioteca). As ferramentas nunca fazem login, recebem pagamentos nem alteram nada: cada título é retornado com o endereço de sua página em libraryofalexandria.com, onde a pessoa lê, ouve, imprime ou começa.

Três formas de acesso

MCP (Streamable HTTP) em https://mcp.libraryofalexandria.com/mcp: para Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose e qualquer outro cliente MCP.
REST e OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> e o arquivo OpenAPI em https://api.libraryofalexandria.com/v1/openapi.json: para scripts, ferramentas de automação (n8n, Zapier, Make, Dify, Flowise), servidores de ferramentas do Open WebUI e Copilot Studio.
Arquivos de ferramentas para desenvolvedores de modelos: GET https://api.libraryofalexandria.com/v1/tools?format=openai: para qualquer programa que envie definições de ferramentas a um modelo. Os formatos são openai, openai-chat, anthropic, gemini, ollama e mcp.

Experimente em um minuto

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

A resposta é {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Cada título em data.results tem um id, um title, um author e a url de sua página.

As dezenove ferramentas

Oito buscam um título, uma mostra as edições impressas, quatro preparam um exemplar impresso pessoal e seis ajudam a pessoa a estudar e escolher. Escolha as ferramentas que um assistente vê usando ?toolset= no endereço MCP; uma lista curta é adequada para modelos locais pequenos:

https://api.libraryofalexandria.com/mcp: as dezenove ferramentas públicas, sem login (o endereço das nossas listagens em diretórios).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: as mesmas dezenove ferramentas públicas.
?toolset=catalogue,orders: as treze ferramentas que buscam um título, mostram suas edições impressas e preparam um exemplar impresso pessoal.
?toolset=study: as seis ferramentas de estudo.
https://mcp.libraryofalexandria.com/mcp sem toolset: as dezenove ferramentas públicas e as sete ferramentas da biblioteca pessoal, vinte e seis ao todo; as sete respondem apenas com a permissão da pessoa.

search_books (query, language, limit): encontre títulos por palavras de um título, um autor ou um tema, em qualquer idioma do catálogo.
get_book (id, language): os dados de um título: autor, título original, capa, edições impressas e sua página em cada idioma.
get_summary (id, language, part): a primeira ideia principal do resumo de 15 minutos de um título, na íntegra, e os cabeçalhos das demais.
get_sample (id, language, page): o início gratuito de um título, em páginas de no máximo 400 palavras.
list_free_shelf (language, subject, limit): os títulos da estante gratuita, por idioma e assunto.
read_free_chapter (id, chapter, page, language): um capítulo de um título da estante gratuita, em páginas de no máximo 400 palavras.
get_print_options (id, language): as edições impressas de um título (letra padrão e letra grande, brochura ou capa dura), com o preço de cada uma em dólares americanos.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): o preço de um exemplar impresso de um título com uma página de mensagem pessoal, o total para a quantidade de exemplares e a página onde a mensagem é escrita e o pedido é feito.
get_cover_upload_link (id, language): a página onde a pessoa adiciona sua própria imagem de capa a um exemplar impresso.
create_custom_print_order (quote_id): a página onde a pessoa escreve a mensagem, vê a prova e paga. Nenhum pedido ou pagamento é feito pelo assistente.
get_order_status (order_ref, email, language): o andamento de um pedido de livros impressos.
get_publisher_info: quem publica a biblioteca, seus idiomas, os termos e a página de privacidade.
browse_collection (collection, language, limit, cursor): uma estante pronta, com oito títulos por vez: os livros grátis, os de nível fácil, médio ou desafiador, os livros perdidos, os títulos com resumo e os mais populares.
get_book_facts (id, language): os dados de leitura de um título: nível, extensão, tempo de leitura em três ritmos, páginas, duração do áudio e ano da primeira publicação.
get_themes (id, language): o guia de estudo de um título: temas, símbolos, ambientação e motivos recorrentes, com o endereço do guia completo.
get_chapter_summary (id, language, chapter): o resumo de um capítulo, ato ou cena, ou a lista de capítulos quando nenhum capítulo é informado.
find_quote_source (quote, language): o texto disponível, o capítulo e o parágrafo de onde vem uma citação de pelo menos seis palavras. Indica as localizações e nunca retorna as palavras de um livro.
explain_phrase (phrase, language): o significado de um ditado ou expressão idiomática, sua origem e os títulos que o utilizam.
recommend_classics (query, language, level, free_only, limit): o que ler a seguir, a partir de um título de que a pessoa gostou, de um tema ou de um estado de espírito.

Um resumo, uma página de amostra ou um capítulo da estante gratuita que ainda não esteja disponível (um título, um idioma ou todos os textos antes de entrarem no ar) responde claramente que estará disponível aqui em breve. Depois, o conteúdo aparece sem nenhuma alteração do seu lado. Não há ferramenta que retorne um livro inteiro: as ferramentas retornam trechos pequenos e limitados e contam as palavras fornecidas a cada cliente (72,000 por dia e 48,000 por hora; a resposta mostra quanto resta).

Conecte um assistente

Todas as vinte e seis ferramentas são apenas de leitura, então qualquer cliente pode permiti-las sem pedir autorização a cada vez. O endereço é https://mcp.libraryofalexandria.com/mcp (adicione ?toolset=catalogue,study,orders, ou use https://api.libraryofalexandria.com/mcp, para acessar apenas as dezenove ferramentas públicas).

Claude: Configurações, Conectores, Adicionar conector personalizado. No Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: abra chatgpt.com/plugins, escolha o botão de adição e Adicionar servidor MCP personalizado, insira o endereço e crie o plugin.
Cursor: adicione "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} em mcpServers no arquivo ~/.cursor/mcp.json.
VS Code: execute MCP: Adicionar Servidor na Paleta de Comandos, escolha HTTP e insira o endereço.
LM Studio (0.3.17 ou mais recente): aba Programa, Instalar, Editar mcp.json; depois, adicione a mesma entrada url em mcpServers.
Open WebUI (0.6.31 ou mais recente): Configurações, Administração, Integrações, Servidores de Ferramentas Externas, Adicionar Conexão, tipo MCP (Streamable HTTP), o endereço, sem autenticação. Ou escolha o tipo OpenAPI e insira o endereço do arquivo OpenAPI.
OpenAI Responses API: passe {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} em tools.

Modelos locais pequenos funcionam melhor com uma lista curta de ferramentas: conecte apenas as ferramentas necessárias para a tarefa.

Sua própria biblioteca (sete ferramentas, com sua permissão)

Uma pessoa com conta em libraryofalexandria.com pode permitir que seu próprio assistente consulte sua biblioteca e converse sobre o livro que ela está lendo. O assistente pede uma vez; a pessoa aprova em libraryofalexandria.com e pode desconectá-lo a qualquer momento na página de assistentes conectados.

get_my_plan: o plano, seu status e quantas palavras de texto ainda estão disponíveis hoje.
list_my_library: os livros da biblioteca, por status (quero ler, lendo, concluído, pausado, abandonado).
get_book_outline: os capítulos de um livro e quais são gratuitos, abertos ou bloqueados. Sem texto.
get_listen_link: o endereço da página para ouvir um livro ou capítulo.
open_in_reader: o endereço de um capítulo (e parágrafo) no leitor.
search_in_book: uma busca por palavra-chave nos capítulos abertos de um livro: trechos curtos com um localizador.
get_passage: uma passagem a partir de um localizador, com no máximo 400 palavras, uma citação e um endereço.

O texto vem apenas de livros cujo texto está aberto e de capítulos que a pessoa pode ler, com no máximo 400 palavras por vez. A conexão usa OAuth 2.1 com PKCE: os documentos estão em /.well-known/oauth-protected-resource/mcp e /.well-known/oauth-authorization-server; uma chamada sem token retorna 401 com um cabeçalho WWW-Authenticate que aponta para esses endereços. Um assistente se registra com um documento de metadados de ID do cliente ou POST /oauth/register (cinco novos clientes por hora a partir de um mesmo endereço).

Chame a API REST

Cada ferramenta é uma operação, POST /v1/<tool>, com os argumentos da ferramenta como um objeto JSON e sem chave.

// JavaScript (Node 18 ou mais recente, navegadores, 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, apenas a biblioteca padrão
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"])

O arquivo OpenAPI e os arquivos de ferramentas

O arquivo OpenAPI 3.1 em /v1/openapi.json descreve cada operação, seus argumentos e a estrutura da resposta. Importe-o para Open WebUI, Dify, Flowise, Copilot Studio ou qualquer ferramenta OpenAPI. Para programas que passam definições de ferramentas a um modelo, GET /v1/tools?format= retorna as ferramentas no formato que cada fornecedor espera (adicione &toolset=catalogue,study,orders para obter apenas as dezenove ferramentas públicas): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama e mcp (a lista exibida pelo servidor MCP). Responda às chamadas feitas pelo modelo com as operações REST acima.

Erros

Um problema é retornado como application/problem+json (RFC 9457) com type, title, status, detail e um code estável.

400 invalid_json, invalid_request, unknown_format: o corpo não é JSON, um argumento está ausente ou incorreto (o detalhe informa qual), ou o formato do arquivo de ferramentas é desconhecido.
404 unknown_tool, not_found: essa ferramenta ou esse título não existe.
405 method_not_allowed: as ferramentas aceitam POST; os documentos aceitam GET.
413 payload_too_large: o corpo excede 8 KB.
415 unsupported_media_type: o corpo deve estar em JSON.
500 internal: a biblioteca não pôde responder agora. Tente novamente em instantes.

Como usar as respostas

Informe o que a resposta diz e use o url de um título conforme fornecido. Não invente preços nem ofertas.
A biblioteca não é a antiga biblioteca de Alexandria nem a Bibliotheca Alexandrina.
Pagamentos e cadastros são feitos apenas em libraryofalexandria.com. Uma ferramenta pode fornecer um link; ela nunca recebe pagamentos.
Não é necessária uma chave. Limite-se a poucas solicitações por segundo e envie um User-Agent que identifique seu programa.

Termos para desenvolvedores

As ferramentas públicas podem ser usadas gratuitamente, sem chave, dentro dos limites desta página. Uma chave de desenvolvedor, criada por uma pessoa conectada em libraryofalexandria.com, aumenta os limites e mostra seu uso; o plano gratuito permite 60 chamadas por minuto e 1.000 chamadas por mês civil para a conta, independentemente da quantidade de chaves que ela tenha.
Use as respostas para ajudar uma pessoa a encontrar, ler e encomendar livros. Informe o que a resposta diz, mantenha o link para nossa página e não apresente nossos resumos, guias de estudo ou textos como seus.
Não copie nossos textos, resumos ou guias de estudo em massa, não os armazene como base para respostas, não os revenda nem os use para treinar um modelo. Isso exige uma licença por escrito: consulte Licenças de IA e dados.
Não tente contornar limites, compartilhar chaves nem chamar as ferramentas de uma forma que as deixe lentas para outras pessoas. Podemos reduzir a velocidade, limitar ou encerrar o acesso de uma chave ou endereço que faça isso, e o titular de uma chave pode revogá-la a qualquer momento.
As ferramentas são fornecidas como estão. Nós as mantemos funcionando e podemos alterar ou desativar uma ferramenta; as mudanças são anunciadas nesta página.

Privacidade

O serviço contabiliza as chamadas por nome da ferramenta, status e nome e versão do cliente. Não armazena o que foi perguntado nem define cookies. Aplicam-se a política de privacidade e os termos de serviço.

Versões

A versão da API é uma data, retornada no cabeçalho LOA-Version (atualmente 2026-10-25). As mudanças são anunciadas nesta página.