HiveCloud CT-e / MDF-e
Transportation fiscal-document issuer from Bsoft by nstech (HiveCloud). Query CT-e (freight bill of
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin connect
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"hivecloud-mcp": {
"url": "https://api.mcp.ai/p_hivecloud"
}
}
}Remote-Endpunkte
https://api.mcp.ai/p_hivecloudstreamable-httpWas es kann
Tool-Inventar
Tools (33)
🟢hivecloud_list_accounts(account)
Lista as contas HiveCloud conectadas a este install (cada usuário+ambiente = uma conta).
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis