# HiveCloud CT-e / MDF-e — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hivecloud?ms=1783623600000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hivecloud_cte_averbar`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hivecloud`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hivecloud/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hivecloud/cte/averbar` — Averba (registra o seguro de carga) um ou mais CT-e (por id). Exige allow_writes.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/cte/cancelar` — ATO FISCAL REAL: cancela um ou mais CT-e autorizados (por id) junto à SEFAZ. Irreversível. Exige allow_writes.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/cte/carta/correcao` — 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
  - body: { cte_id: string, correcoes: object, empresa_id?: string, account?: string, cte_ids?: string[], empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/cte/emitir` — 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.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/cte/excluir` — Exclui um ou mais CT-e (rascunhos/rejeitados, por id). Irreversível. Exige allow_writes.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/get/cte` — Detalha um CT-e específico pelo id.
  - body: { id: string, empresa_id?: string, account?: string, ids?: string[], empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/list/accounts` — Lista as contas HiveCloud conectadas a este install (cada usuário+ambiente = uma conta).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/hivecloud/list/ctes` — 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
  - body: { empresa_id?: string, pageSize?: integer, pageNumber?: integer, data_inicial?: string, data_final?: string, account?: string, empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/list/dces` — Lista as DC-e (Declaração de Conteúdo eletrônica) da empresa, paginado.
  - body: { empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/list/empresas` — Lista as empresas emitentes do ambiente (id, nome, cnpj). O `id` é o `empresa_id` exigido nas demais tools (passo de seleção da empresa).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/hivecloud/list/inutilizacoes` — Lista as inutilizações de numeração de CT-e da empresa, paginado.
  - body: { empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/list/mdfes` — 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
  - body: { empresa_id?: string, pageSize?: integer, pageNumber?: integer, data_inicial?: string, data_final?: string, account?: string, empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/list/motoristas` — Lista os motoristas/condutores cadastrados (nome, cpf, cnh), usados no MDF-e, paginado. Exige mdfe_tenant_id na conexão.
  - body: { empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/list/veiculos` — Lista os veículos cadastrados (placa, motorista, reboque, tara), usados no MDF-e, paginado. Exige mdfe_tenant_id na conexão.
  - body: { empresa_id?: string, pageSize?: integer, pageNumber?: integer, account?: string, empresa_ids?: string[] }
- `POST https://api.mcp.ai/api/hivecloud/mdfe/cancelar` — ATO FISCAL REAL: cancela um ou mais MDF-e (por id) junto à SEFAZ. Irreversível. Exige allow_writes + mdfe_tenant_id.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/mdfe/emitir` — ATO FISCAL REAL: transmite um ou mais MDF-e à SEFAZ (por id). Exige allow_writes + mdfe_tenant_id.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/mdfe/empresas` — 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.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/hivecloud/mdfe/encerrar` — ATO FISCAL REAL: encerra um ou mais MDF-e (por id) após o fim da viagem. Exige allow_writes + mdfe_tenant_id.
  - body: { ids: string[], empresa_id?: string, account?: string }
- `POST https://api.mcp.ai/api/hivecloud/sefaz/status` — Status do serviço da SEFAZ para a empresa (se o servidor da Fazenda está em operação).
  - body: { empresa_id?: string, account?: string, empresa_ids?: string[] }

## 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"

## More
- Page: https://mcp.ai/hivecloud
- Agent spec (llms.txt): https://mcp.ai/hivecloud/llms.txt
- Postman collection: https://mcp.ai/hivecloud/postman.json