HiveCloud CT-e / MDF-e
Transportation fiscal-document issuer from Bsoft by nstech (HiveCloud). Query CT-e (freight bill of
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen connect
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"hivecloud-mcp": {
"url": "https://api.mcp.ai/p_hivecloud"
}
}
}Puntos de conexión remotos
https://api.mcp.ai/p_hivecloudstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (33)
🟢hivecloud_list_accounts(account)
Lista as contas HiveCloud conectadas a este install (cada usuário+ambiente = uma conta).
Esquema de entrada
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_empresas(account)
Lista as empresas emitentes do ambiente (id, nome, cnpj). O `id` é o `empresa_id` exigido nas demais tools (passo de seleção da empresa).
Esquema de entrada
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_ctes(empresa_id, pageSize, pageNumber, data_inicial, data_final, ...)
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, datas e status de averbação. Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"pageNumber": {
"type": "number"
},
"data_inicial": {
"type": "string"
},
"data_final": {
"type": "string"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_get_cte(id, empresa_id, account, ids, empresa_ids)
Detalha um CT-e específico pelo id. Bulk support: accepts ids, empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_cte_dacte(ids, empresa_id, account)
Gera o PDF do DACTE de um ou mais CT-e autorizados e devolve a URL de download (temporária). Mesma ação do botão Imprimir DACTe do emissor, não altera o documento.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_cte_xml(ids, empresa_id, account)
Exporta o XML de um ou mais CT-e (zip) e devolve a URL de download (temporária). Mesma ação do botão Exportar XML do emissor, não altera o documento.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_nfe_info(chave, empresa_id, account, empresa_ids)
Consulta os dados de uma NF-e pela chave de acesso (44 dígitos) via emissor: remetente e destinatário (já resolvidos no cadastro), valor da carga, pesos, volumes e produto predominante. É o passo antes de criar o CT-e. A consulta conta na franquia de consultas de NF-e do plano do emissor. Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"chave": {
"type": "string"
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"chave"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪hivecloud_cte_criar_de_nfe(nfe_chaves, valor_frete, tomador, responsavel_frete, cfop_codigo, ...)
Cria um RASCUNHO de CT-e a partir de uma ou mais chaves de NF-e (mesmo remetente e destinatário). Importa os dados da nota, usa o último CT-e autorizado da empresa como base de imposto/CFOP/local de emissão e preenche carga, valores e envolvidos. NÃO transmite à SEFAZ: o documento fica em digitação pra revisão e emissão. Exige allow_writes na conexão. Bulk support: accepts template_cte_ids, empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"nfe_chaves": {
"type": "array",
"items": {
"type": "string"
}
},
"valor_frete": {
"type": "number"
},
"tomador": {
"type": "string",
"enum": [
"remetente",
"destinatario"
]
},
"responsavel_frete": {
"type": "string",
"enum": [
"REMETENTE",
"DESTINATARIO",
"EXPEDIDOR",
"RECEBEDOR",
"TERCEIROS"
]
},
"cfop_codigo": {
"type": "string"
},
"cfop_natureza": {
"type": "string"
},
"produto_predominante": {
"type": "string"
},
"observacao": {
"type": "string"
},
"template_cte_id": {
"type": "string"
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
},
"template_cte_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"nfe_chaves",
"valor_frete"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_dces(empresa_id, pageSize, pageNumber, account, empresa_ids)
Lista as DC-e (Declaração de Conteúdo eletrônica) da empresa, paginado. Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"pageNumber": {
"type": "number"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_inutilizacoes(empresa_id, pageSize, pageNumber, account, empresa_ids)
Lista as inutilizações de numeração de CT-e da empresa, paginado. Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"pageNumber": {
"type": "number"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_sefaz_status(empresa_id, account, empresa_ids)
Status do serviço da SEFAZ para a empresa (se o servidor da Fazenda está em operação). Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_mdfe_empresas(account)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_mdfes(empresa_id, pageSize, pageNumber, data_inicial, data_final, ...)
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 (ambiente do MDF-e, distinto do CT-e). Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"pageNumber": {
"type": "number"
},
"data_inicial": {
"type": "string"
},
"data_final": {
"type": "string"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_get_mdfe(id, empresa_id, account, ids, empresa_ids)
Detalha um MDF-e pelo id: placa do veículo (dadosVeiculo), condutores (nome/CPF), CIOT, documentos vinculados (chaves de CT-e/NF-e), UFs, valor e peso da carga, status e protocolos. A listagem não traz esses campos, só o detalhe. Exige mdfe_tenant_id na conexão. Bulk support: accepts ids, empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_mdfe_damdfe(ids, empresa_id, account)
Gera o PDF do DAMDFE de um ou mais MDF-e e devolve a URL de download (temporária). Mesma ação do botão de impressão do emissor, não altera o documento. Exige mdfe_tenant_id na conexão.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_mdfe_xml(ids, empresa_id, account)
Exporta o XML de um ou mais MDF-e (zip) e devolve a URL de download (temporária). Não altera o documento. Exige mdfe_tenant_id na conexão.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_relatorio_viagens(empresa_ids, data_inicial, data_final, placa, motorista, ...)
Relatório consolidado de viagens (MDF-e) por período: contagem por mês, ranking por placa e por motorista, com filtros por placa e/ou motorista (CPF ou nome) e faturamento opcional (soma do valorTotalFrete dos CT-e vinculados a cada MDF-e). Consolida N empresas numa chamada (empresa_ids; omitido = todas). Resolve tudo server-side (lista o período e detalha cada MDF-e). Cancelados ficam fora por padrão. Exige mdfe_tenant_id na conexão. Responde perguntas como: quantas cargas a placa X fez no trimestre e quanto faturou.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"data_inicial": {
"type": "string"
},
"data_final": {
"type": "string"
},
"placa": {
"type": "string"
},
"motorista": {
"type": "string"
},
"incluir_cancelados": {
"type": "boolean"
},
"incluir_faturamento": {
"type": "boolean"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_veiculos(empresa_id, pageSize, pageNumber, account, empresa_ids)
Lista os veículos cadastrados (placa, motorista, reboque, tara), usados no MDF-e, paginado. Exige mdfe_tenant_id na conexão. Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"pageNumber": {
"type": "number"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hivecloud_list_motoristas(empresa_id, pageSize, pageNumber, account, empresa_ids)
Lista os motoristas/condutores cadastrados (nome, cpf, cnh), usados no MDF-e, paginado. Exige mdfe_tenant_id na conexão. Bulk support: accepts empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"empresa_id": {
"type": "string"
},
"pageSize": {
"type": "number"
},
"pageNumber": {
"type": "number"
},
"account": {
"type": "string"
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪hivecloud_cte_emitir(ids, empresa_id, account)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴hivecloud_cte_cancelar(ids, empresa_id, account)
ATO FISCAL REAL: cancela um ou mais CT-e autorizados (por id) junto à SEFAZ. Irreversível. Exige allow_writes.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴hivecloud_cte_excluir(ids, empresa_id, account)
Exclui um ou mais CT-e (rascunhos/rejeitados, por id). Irreversível. Exige allow_writes.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪hivecloud_cte_averbar(ids, empresa_id, account)
Averba (registra o seguro de carga) um ou mais CT-e (por id). Exige allow_writes.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪hivecloud_cte_carta_correcao(cte_id, correcoes, empresa_id, account, cte_ids, ...)
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, finalidadeEmissao, localEmissao, remetente, destinatario, ...}). Exige allow_writes. Bulk support: accepts cte_ids, empresa_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"cte_id": {
"type": "string"
},
"correcoes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
},
"cte_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"cte_id",
"correcoes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪hivecloud_mdfe_emitir(ids, empresa_id, account)
ATO FISCAL REAL: transmite um ou mais MDF-e à SEFAZ (por id). Exige allow_writes + mdfe_tenant_id.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪hivecloud_mdfe_encerrar(ids, empresa_id, account)
ATO FISCAL REAL: encerra um ou mais MDF-e (por id) após o fim da viagem. Exige allow_writes + mdfe_tenant_id.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴hivecloud_mdfe_cancelar(ids, empresa_id, account)
ATO FISCAL REAL: cancela um ou mais MDF-e (por id) junto à SEFAZ. Irreversível. Exige allow_writes + mdfe_tenant_id.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"empresa_id": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Esquema de entrada
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢connect
Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
Esquema de entrada
{
"type": "object",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
Esquema de entrada
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Comunidad
Evidencia