@databolsa/credit-mcp

Servidor MCP da mesa de crédito do DataBolsa. Ele transforma as operações do contrato da mesa em tools com schemas de entrada e saída. São sete — o protocolo do módulo: catálogo, spec e execução de Functions (leituras) e Actions (escritas). O que a mesa faz não é uma tool por recurso; é o catálogo que creditListFunctions e creditListActions devolvem, com cada capacidade chamada por id.

Rodar

DATABOLSA_CREDIT_API_KEY=db_live_SUACHAVE \
npx -y @databolsa/credit-mcp

O transporte é stdio. Guarde a chave em configuração local não versionada.

Descobrir as tools

Use o catálogo e os schemas mostrados pelo próprio cliente MCP. Eles são gerados do OpenAPI da mesa e substituem listas manuais de tools. Uma sessão nasce com sete tools; a creditListFunctions diz quais leituras existem e a creditGetFunction traz o input_schema de uma delas. Para dados públicos de crédito e mercado no mesmo agente, adicione também @databolsa/mcp.

| Variável | Uso | | --- | --- | | DATABOLSA_CREDIT_API_URL | Origem da API; padrão https://api.databolsa.com. | | DATABOLSA_CREDIT_API_KEY | Chave pessoal do membro. |

Recursos fora do escopo respondem 404. Licença vencida bloqueia escritas com 402, mas mantém leituras. Toda escrita é auditada: o agente deve confirmar alvo e efeito antes de criar, alterar ou excluir. Preserve unidades e valores ausentes conforme o schema da tool.

O mesmo contrato está disponível em @databolsa/credit-sdk e @databolsa/credit-cli.

Apache-2.0. O servidor não executa ordens nem movimenta dinheiro.