# HiveCloud CT-e / MDF-e — MCP server on mcp.ai
> Transportation fiscal-document issuer from Bsoft by nstech (HiveCloud). Query CT-e (freight bill of lading), MDF-e (electronic manifest), DC-e, number voidings, SEFAZ status, plus vehicles and drivers. Connect with your issuer username, password and environment. Read-only in this version.

By: mcp.ai · official
Page: https://mcp.ai/hivecloud

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_hivecloud?ms=1783623660000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/hivecloud/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/hivecloud/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/hivecloud/skill.md
Postman collection (v2.1): https://mcp.ai/hivecloud/postman.json

## Tools
- hivecloud_cte_averbar(ids: string[], empresa_id?: string, account?: string) — Averba (registra o seguro de carga) um ou mais CT-e (por id). Exige allow_writes.
- hivecloud_cte_cancelar(ids: string[], empresa_id?: string, account?: string) — ATO FISCAL REAL: cancela um ou mais CT-e autorizados (por id) junto à SEFAZ. Irreversível. Exige allow_writes.
- hivecloud_cte_carta_correcao(cte_id: string, correcoes: object, empresa_id?: string, account?: string, cte_ids?: string[], empresa_ids?: string[]) — ATO FISCAL REAL: emite uma carta de correção (CC-e) para um CT-e autorizado. `correcoes` é um objeto só com os campos a corrigir (ex.: {caracteristicaAdicionalTransporte, tipoServico, finalidadeEmissa
- hivecloud_cte_emitir(ids: string[], empresa_id?: string, account?: string) — ATO FISCAL REAL: transmite um ou mais CT-e à SEFAZ (por id). Opera sobre documentos já criados/em digitação. Exige allow_writes habilitado na conexão.
- hivecloud_cte_excluir(ids: string[], empresa_id?: string, account?: string) — Exclui um ou mais CT-e (rascunhos/rejeitados, por id). Irreversível. Exige allow_writes.
- hivecloud_get_cte(id: string, empresa_id?: string, account?: string, ids?: string[], empresa_ids?: string[]) — Detalha um CT-e específico pelo id.
- hivecloud_list_accounts(account?: string) — Lista as contas HiveCloud conectadas a este install (cada usuário+ambiente = uma conta).
- hivecloud_list_ctes(empresa_id?: string, pageSize?: integer, pageNumber?: integer, data_inicial?: string, data_final?: string, account?: string, empresa_ids?: string[]) — Lista os CT-e (Conhecimento de Transporte eletrônico) da empresa, paginado, com filtro por data de emissão. Retorna número, série, UF inicial/final, valor do frete, remetente/destinatário, status, dat
- hivecloud_list_dces(empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[]) — Lista as DC-e (Declaração de Conteúdo eletrônica) da empresa, paginado.
- hivecloud_list_empresas(account?: string) — Lista as empresas emitentes do ambiente (id, nome, cnpj). O `id` é o `empresa_id` exigido nas demais tools (passo de seleção da empresa).
- hivecloud_list_inutilizacoes(empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[]) — Lista as inutilizações de numeração de CT-e da empresa, paginado.
- hivecloud_list_mdfes(empresa_id?: string, pageSize?: integer, pageNumber?: integer, data_inicial?: string, data_final?: string, account?: string, empresa_ids?: string[]) — Lista os MDF-e (Manifesto Eletrônico de Documentos Fiscais) da empresa, paginado (número, série, dataEmissao, statusMdfe, UF de carregamento/descarregamento, CIOT). Exige mdfe_tenant_id na conexão (am
- hivecloud_list_motoristas(empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[]) — Lista os motoristas/condutores cadastrados (nome, cpf, cnh), usados no MDF-e, paginado. Exige mdfe_tenant_id na conexão.
- hivecloud_list_veiculos(empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[]) — Lista os veículos cadastrados (placa, motorista, reboque, tara), usados no MDF-e, paginado. Exige mdfe_tenant_id na conexão.
- hivecloud_mdfe_cancelar(ids: string[], empresa_id?: string, account?: string) — ATO FISCAL REAL: cancela um ou mais MDF-e (por id) junto à SEFAZ. Irreversível. Exige allow_writes + mdfe_tenant_id.
- hivecloud_mdfe_emitir(ids: string[], empresa_id?: string, account?: string) — ATO FISCAL REAL: transmite um ou mais MDF-e à SEFAZ (por id). Exige allow_writes + mdfe_tenant_id.
- hivecloud_mdfe_empresas(account?: string) — Lista as empresas emitentes do ambiente de MDF-e (o MDF-e tem ambiente e empresas PRÓPRIOS, distintos do CT-e). O `id` é o `empresa_id` das tools de MDF-e. Exige mdfe_tenant_id na conexão.
- hivecloud_mdfe_encerrar(ids: string[], empresa_id?: string, account?: string) — ATO FISCAL REAL: encerra um ou mais MDF-e (por id) após o fim da viagem. Exige allow_writes + mdfe_tenant_id.
- hivecloud_sefaz_status(empresa_id?: string, account?: string, empresa_ids?: string[]) — Status do serviço da SEFAZ para a empresa (se o servidor da Fazenda está em operação).

## Example prompts
- "List the CT-e issued this month for the company"
- "What is the SEFAZ service status right now?"
- "Show the latest MDF-e and the registered vehicles"

## Links
Docs: https://mcp.ai/docs/mcps/hivecloud
Website: https://mcp.ai/mcps/hivecloud