Credit Desk

O Credit Desk é a extensão organizacional para pesquisa e diligência de crédito privado. Ela combina os objetos e documentos públicos do core com notas, termos extraídos e decisões de revisão que pertencem à organização.

Não existe um portal separado. No Notebook, a extensão começa por uma busca de classe de FIDC, cedente, debênture, CRI ou CRA. A ficha do objeto reúne cadastro, séries, relações e termos do regulamento; comparações e perguntas abertas seguem para a conversa principal.

Revisão humana, procedência preservada

Termos extraídos de regulamentos entram como pendentes, com trecho e página. Uma pessoa da organização confirma ou rejeita a extração, e a decisão fica registrada. Conteúdo pendente nunca deve ser apresentado como covenant vigente.

A experiência atual do Notebook privilegia busca, ficha e fila de revisão. O contrato também mantém operações para integrações organizacionais, como notas, watchlists e alertas, sem exigir que cada uma se torne um painel na UI.

No agente

As capacidades de crédito entram quando a extensão está instalada e o ativo ou recurso relevante está em contexto. Dados públicos continuam vindo dos objetos do mercado; notas e revisões vêm do data plane da organização.

Cada número deve preservar competência e fonte. Cláusulas devem citar documento e página; ausência de cobertura não deve ser convertida em zero ou conclusão.

Functions e Actions

O contrato da mesa é chamado por id, não por caminho. As Functions são as leituras (credit.watchlists.list, credit.watchlist.board, credit.alerts.list, credit.regulation_terms.queue, credit.notes.list) e as Actions são as escritas (credit.note.create, credit.regulation_term.review). Cada superfície tem catálogo, spec com schemas e execução em /v1/desk/functions e /v1/desk/actions.

curl -X POST https://api.databolsa.com/v1/desk/functions/credit.notes.list/execute \
  -H "authorization: Bearer $DATABOLSA_CREDIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{"subject":{"entity_id":"org_abc123"},"input":{"limit":20}}'

O sujeito é a mesa; nas leituras endereçadas por lista (credit.watchlist.items, credit.watchlist.board, credit.alerts.list) é a watchlist. O contrato publica sete operações e nenhuma rota por recurso: uma sessão MCP nasce com sete tools que alcançam tudo o que a mesa faz, e o catálogo diz quais capacidades existem. O SDK expõe os mesmos sete métodos, e neles o id escolhe o input aceito e o tipo do result:

import { DataBolsaCredit } from "@databolsa/credit-sdk";

const desk = new DataBolsaCredit({ apiKey: process.env.DATABOLSA_CREDIT_API_KEY });

const notas = await desk.executeFunction("credit.notes.list", {
  subject: { entity_id: "org_abc123" },
  input: { entity_id: "12345678000195", limit: 20 },
});
notas.result.data[0].body; // string, sem cast

const nova = await desk.executeAction("credit.note.create", {
  input: { org: "org_abc123", entity_id: "12345678000195", body: "Concentração subiu." },
  confirmed: true,
});
nova.result.id; // string

Id publicado depois da versão instalada do SDK vai em executeFunctionAny ou executeActionAny, que devolvem result sem tipo.

API e clientes

• Referência da API
• OpenAPI
• @databolsa/credit-sdk
• @databolsa/credit-cli
• @databolsa/credit-mcp para uso local

export DATABOLSA_CREDIT_API_KEY=db_live_SUACHAVE
npx -y @databolsa/credit-cli --list
npx -y @databolsa/credit-cli creditListFunctions --json
npx -y @databolsa/credit-cli creditGetFunction credit.regulation_terms.queue --json

Recursos fora da mesa respondem 404. Licença vencida bloqueia escrita com 402 license_required, mas preserva leitura. Toda escrita organizacional é auditada.

O DataBolsa fornece evidência e contexto para análise de crédito; não transforma correlação, limiar ou saída de modelo em recomendação de investimento.