Skip to main content
Glama
Sign In

Softoteca

by br.com.softoteca
OverviewDiscussionsAdmin

Buscar softwares

buscar_softwares
Read-onlyIdempotent

Busca softwares no catálogo publicado da Softoteca, o catálogo de software do Brasil (B2B e B2C), com preços em reais. Use quando a pessoa pedir indicação, lista ou opções de software para uma necessidade (ex.: controle de ponto, ERP, emissão de nota fiscal), com filtros opcionais de categoria, tipo, plataforma e preço máximo. Devolve até 20 softwares por chamada, em ordem alfabética, com resumo factual, fornecedor, categorias, menor preço publicado e url_canonica. Para os detalhes de um software, use obter_ficha.

Input Schema

NameRequiredDescriptionDefault
tipoNoB2B para software de empresas, B2C para software de consumidores. Software que atende os dois entra nos dois.
origemNoOrigem da empresa fornecedora: brasileira (sede no Brasil, comprovada no site do fornecedor) ou internacional (a filial brasileira de grupo estrangeiro conta como internacional). Fica de fora o software cujo fornecedor ainda não tem a origem comprovada; nas respostas, ele vem com fornecedor.origem null.
paginaNoPágina dos resultados, a partir de 1. São 20 por página.
consultaYesO que se procura, em poucas palavras (ex.: "controle de ponto", "emissão de NFS-e"). Cada palavra precisa aparecer no nome, no resumo, na descrição, no fornecedor ou nas categorias, sem diferença de acento ou de maiúsculas. Pode ficar vazia quando houver outro filtro.
categoriaNoSlug da categoria, como vem da lista de categorias (ex.: "controle-de-ponto"). Veja listar_categorias.
plataformaNoPlataforma em que o software precisa rodar: web, windows, macos, linux, ios, android.
preco_max_brlNoPreço máximo em reais. Fica o software com plano gratuito ou com ao menos um plano de preço publicado até esse valor, na periodicidade do próprio plano (mensal, anual ou pagamento único). O plano com preço em dólar ou euro não entra neste filtro: a Softoteca não converte.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / preco_max_brl / description
      Previous value: -"Preço máximo em reais. Fica o software com plano gratuito ou com ao menos um plano de preço publicado até esse valor, na periodicidade do próprio plano (mensal, anual ou pagamento único)."New value: +"Preço máximo em reais. Fica o software com plano gratuito ou com ao menos um plano de preço publicado até esse valor, na periodicidade do próprio plano (mensal, anual ou pagamento único). O plano com preço em dólar ou euro não entra neste filtro: a Softoteca não converte."
  2. Changed1 schema field changed
    • addedInput schema / properties / origem
      Added value: +{
+  "description": "Origem da empresa fornecedora: brasileira (sede no Brasil, comprovada no site do fornecedor) ou internacional (a filial brasileira de grupo estrangeiro conta como internacional). Fica de fora o software cujo fornecedor ainda não tem a origem comprovada; nas respostas, ele vem com fornecedor.origem null.",
+  "enum": [
+    "brasileira",
+    "internacional"
+  ],
+  "type": "string"
+}
  3. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive/closed-world, so the heavy safety lifting is done. The description adds genuinely useful behavior beyond them: 20 results per call, alphabetical ordering, and the exact payload returned (resumo factual, fornecedor, categorias, menor preço, url_canonica).

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

Conciseness5/5

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

Three sentences, front-loaded with purpose, then trigger conditions, then the return contract and the handoff to obter_ficha. Every clause carries information an agent needs and nothing is repeated.

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?

No output schema exists, and the description compensates by specifying result count, ordering, and returned fields. With seven fully described parameters and annotations already covering the safety profile, nothing essential is missing for correct invocation.

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

Parameters3/5

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

Schema description coverage is 100%, so the enum and field semantics (tipo, origem, plataforma, preco_max_brl) are already fully documented. The description only restates that categoria, tipo, plataforma and preço máximo are optional filters, adding no new meaning beyond the schema; baseline 3 applies.

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?

States a specific verb and resource ("Busca softwares") plus the exact corpus it searches (catálogo publicado da Softoteca, B2B e B2C, preços em reais), which immediately separates it from siblings that operate on a single software or on aggregate statistics.

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?

Gives an explicit trigger ("Use quando a pessoa pedir indicação, lista ou opções de software para uma necessidade") with concrete examples, and routes detail lookups to obter_ficha. It does not mention alternativas or comparar_softwares, so the agent must infer when a comparison or alternatives query should leave this tool — a gap, but the core routing is clear.

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

All Softoteca toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources