Referência de API

Ferramentas MCP, endpoints REST e os dois documentos OpenAPI diferentes que existem hoje.

Ferramentas MCP

Nomes canônicos, toolsets, aliases, deprecadas.

Endpoints REST

Rotas do engine voltadas ao cliente, no valorbrain-api.

Catálogo MCP (gerado)

src/tool-catalog.ts, reconstruído junto com as docs.

REST (gerado)

Todos os paths OpenAPI do engine, reconstruídos junto com as docs.

OpenAPI — dois arquivos, não confunda

URL	O que de fato é
`https://valorbrain.valor.digital/openapi.json`	Documento de descoberta do SaaS. 4 paths (ingest, device code, health-class). ~6.7 KB.
`https://docs.valor.digital/openapi.json`	OpenAPI do engine, regenerado no build das docs (servers reescritos para valorbrain-api).
`docs/reference/openapi.yaml` no repositório do engine	Spec completa do engine. 116 paths, incluindo ops/graph. Não publicada no `valorbrain-api` (esse host dá 404 em `/openapi.json`).

O arquivo de 4 paths é real e útil para descoberta por agentes no host de marketing. Ele não é uma descrição do /search. Use este site e a página REST para integração.

Docs legíveis por máquina

URL	Conteúdo
`/llms.txt`	Índice + roteamento para agentes
`/llms-full.txt`	Markdown completo de todas as páginas
`/.well-known/mcp/server-card.json`	Card MCP vivo (produto, não este host de docs)
`/.well-known/agent-card.json`	Nosso agent card, apontando para o MCP do produto