Skip to main content
Glama

Buscar livros da Blucher

buscar_livros
Read-onlyIdempotent

Busca livros da Editora Blucher por tema, título, autor ou pergunta em linguagem natural; filtra por área, formato, idioma e disponibilidade. Use sempre que a pessoa quiser saber se a Blucher tem livro sobre um assunto, procurar um título ou autor (tolera erro de digitação) ou montar uma lista de leitura. Por padrão devolve a edição vigente do que está à venda e também os livros fora de catálogo, marcados; de uma obra com edição mais recente, vem a mais recente (e a antiga, com edicao.substituido_por, quando a busca casou com o título dela); um ISBN como consulta devolve o livro desse ISBN (mesmo antigo ou fora de catálogo). Cada livro traz url, o link da página dele em www.blucher.com.br; a ficha completa (preço detalhado, sumário, edições) vem de obter_livro, pelo ISBN.

Search the catalog of Editora Blucher (Brazilian technical, scientific and academic publisher) by topic, title, author or natural-language question; filter by area, format, language and availability. Use it whenever the user asks whether Blucher has a book on a subject, looks for a title or author (typos tolerated) or builds a reading list. By default returns the current edition of books on sale plus out-of-catalog books, flagged; for a work with a newer edition you get the newer one (and the old one, with edicao.substituido_por, when the query matched its title); an ISBN as the query returns that book. Each book carries url, the link to its page on www.blucher.com.br; the full record comes from obter_livro, by ISBN.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "consulta": "<consulta>"
    },
    "name": "buscar_livros"
  }
}

Input Schema

NameRequiredDescriptionDefault
areaNoNome ou prefixo de área (veja catalogo_facetas), ex.: 'Engenharias'. / Area name or prefix.
idiomaNoSigla do idioma (BCP 47): pt-br, en, es; 'pt' casa qualquer português. / Language tag (BCP 47); 'pt' matches any Portuguese.
limiteNoMáximo de resultados (1–20). / Max results.
formatoNoimpresso | digital | audiobook. / Format.
consultaYesTema, título, autor, pergunta ou ISBN, em qualquer idioma. / Topic, title, author, question or ISBN.
apenas_disponiveisNotrue (padrão): o que se compra hoje (impresso à venda ou eBook nas lojas) ou se baixa de graça (eBook de acesso aberto), mais os fora de catálogo enquanto incluir_fora_de_catalogo=true. false inclui também esgotados e pré-lançamentos. / On sale or free (open access), plus out-of-catalog books while incluir_fora_de_catalogo=true.
incluir_fora_de_catalogoNotrue (padrão): também os livros fora de catálogo (disponibilidade=fora_de_catalogo), com a edição mais recente da obra quando houver, como a página do livro. false: tira os que só entraram por esta opção (com apenas_disponiveis=true, fica só o que se compra hoje). / Also out-of-catalog books, with the newer edition when there is one.
incluir_edicoes_anterioresNofalse (padrão): a edição vigente de cada obra (a antiga fora de catálogo só aparece quando a busca casou com o título dela, ao lado da mais recente). / Include previous editions.

Output Schema

NameRequiredDescriptionDefault
avisoNo
resultadosYes
total_consideradoYesQuantos livros a busca considerou antes do corte por `limite` (os candidatos acima dos limiares). Quando a consulta é o nome de uma categoria ('engenharia civil', 'psicanálise'), é o tamanho dela: todos os livros da categoria que passam nos filtros, mais os outros candidatos. / Books considered before the `limite` cut; for a query that names a category, the size of that category.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / $defs / EdicaoResumo / properties / substituido_por / description
      Previous value: -"Em edição antiga: a edição mais recente da obra (o aviso 'Há uma edição mais recente desta obra' da página do livro). Avise a pessoa e cite-a. / Newer edition of this work: tell the user."New value: +"Em edição antiga: a edição mais recente da obra (o aviso 'Há uma edição mais recente desta obra' da página do livro), com título e link (`url`). / The newer edition of this work."
  2. Changed1 schema field changed
    • addedOutput schema / $defs / LivroResultado / properties / url / description
      Added value: +"Página do livro em www.blucher.com.br: o link do livro. / The book's page on www.blucher.com.br."
  3. First observed

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds substantial behavioral detail beyond the readOnly/idempotent/non-destructive annotations: default inclusion of current editions and flagged out-of-catalog books, edition substitution via edicao.substituido_por, ISBN lookup behavior, and the presence of a url field. It fully respects the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and key behavior are front-loaded, but the entire Portuguese paragraph is duplicated in English, nearly doubling length without adding new information. The remaining content is dense but useful; the duplication is the main structural weakness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complex eight-parameter schema, available output schema, and annotations, the description is complete enough for correct invocation. It explains default result composition, edition handling, ISBN behavior, and points to obter_livro for the full record.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds cross-parameter meaning, such as how default availability and out-of-catalog flags interact, how previous editions are suppressed by default, and how an ISBN in consulta behaves.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Busca livros da Editora Blucher') and enumerates supported query modes and filters. It also distinguishes this tool from obter_livro, which provides the full record by ISBN, and references catalogo_facetas for area names.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives clear usage contexts: checking whether Blucher has a book on a subject, looking up a title or author, or building a reading list. It names obter_livro as the alternative for full book details, but does not explicitly state when NOT to use this tool versus other siblings like recomendar_para_ementa or search.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources