MCPBetacrivo_answer_reports

Responder com evidências

Beta: gera uma síntese fundamentada em trechos de relatórios CVM, com afirmações citadas, fontes e estado de cobertura. Confira a disponibilidade via tools/list no servidor conectado.

A chamada e a resposta usam a companhia fictícia DEMO3; substitua pelo ticker desejado ao testar.

Trate status antes de usar a síntese: answered, partial, stale ou insufficient_evidence. Confira coverage_gaps e warnings; a síntese pode ser nula. As citações em claims[].evidence_ids apontam para sources[].evidence_id.

Ver exemplos de código

Esta tool usa o transporte MCP do Crivo. Veja a configuracao do cliente MCP para usar a configuracao canônica antes de chamar a tool.

Parametros

Parametros de body

Nome	Tipo	Exigencia	Descricao
query	string	Obrigatorio	Pergunta sobre os documentos. Não pode ser vazia.
ticker	string	Opcional	Ticker da companhia.
cd_cvm	string	Opcional	Código CVM da companhia.
company_name	string	Opcional	Nome da companhia.
report_types	string[]	Opcional	Tipos de relatório, por exemplo itr, dfp ou fato_relevante. Padrão: lista vazia.
from_date	date	Opcional	Data inicial em YYYY-MM-DD, anterior ou igual à data final.
to_date	date	Opcional	Data final em YYYY-MM-DD.
latest_only	boolean	Opcional	Restringe a busca aos documentos mais recentes.
max_claims	integer	Opcional	Máximo de afirmações, entre 1 e 12. Padrão: 8.

Resposta

Sucesso MCP: JSON-RPC result

Resposta ilustrativa. Valores e datas fictícios; não representa uma consulta atual.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"scope\":{\"ticker\":\"DEMO3\",\"cd_cvm\":null,\"company_name\":\"Companhia fictícia\",\"report_types\":[\"itr\"],\"from_date\":null,\"to_date\":null,\"latest_only\":true},\"status\":\"answered\",\"summary\":\"No exemplo fictício, a dívida se concentra no longo prazo.\",\"claims\":[{\"claim_id\":\"claim_example\",\"statement\":\"A maior parte da dívida vence no longo prazo.\",\"evidence_ids\":[\"evidence_example\"],\"fact_ids\":[\"fact_example\"]}],\"sources\":[{\"evidence_id\":\"evidence_example\",\"document_id\":\"document_example\",\"revision_id\":\"revision_example\",\"chunk_id\":\"chunk_example\",\"report_type\":\"itr\",\"cd_cvm\":null,\"ticker\":\"DEMO3\",\"company_name\":\"Companhia fictícia\",\"source_url\":\"https://example.com/relatorio-ficticio.pdf\",\"page_start\":12,\"page_end\":12,\"published_at\":\"2026-08-01\",\"report_date\":\"2026-06-30\",\"file_hash\":null,\"text_hash\":null}],\"as_of\":\"2026-06-30\",\"coverage_gaps\":[],\"warnings\":[],\"index_generation\":\"index_example\",\"synthesis_model\":\"model_example\",\"prompt_version\":\"report-answer-v1\",\"generated_at\":\"2026-08-01T12:00:00Z\"}"
      }
    ],
    "isError": false
  }
}

Erros

Status	Descricao
-32602	Parametros da tool invalidos.
-32600	Recurso solicitado invalido ou nao encontrado.
-32603	Falha interna ao executar a tool.