# Bsoft TMS — MCP server on mcp.ai
> Official Bsoft TMS API, the leading transportation management system for Brazilian carriers (Bsoft by nstech). Issue and query CT-e, MDF-e and NF-e, access keys, XML and PDF of fiscal documents, finance (payables/receivables, payments, receipts, contracts, reconciliation), fleet and maintenance, freight and bills of lading, trip control and party records. Connect with your Bsoft domain credentials (domain, integration-profile user and password).

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_bsoft?ms=1783111980000
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/bsoft/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/bsoft/<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/bsoft/skill.md
Postman collection (v2.1): https://mcp.ai/bsoft/postman.json

## Tools
- bsoft_controle_viagens(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Controle de Viagens no Bsoft TMS (leitura). Viagens, adiantamentos, despesas, receitas, devoluções, recebimentos, documentos e manifestos da viagem (recursos aninhados usam parent_id = id da viagem).
- bsoft_controle_viagens_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Controle de Viagens no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_controle_viagens_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Controle de Viagens no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_controle_viagens_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Controle de Viagens no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_controle_viagens_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Controle de Viagens no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_controle_viagens_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Controle de Viagens no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_documentos_fiscais(account?: string, kind: string, tipo: string, query?: string, body?: string) — Documentos fiscais eletrônicos do Bsoft (e-Doc) — o caso de uso principal.
- bsoft_documentos_fiscais_evento(account?: string, tipo: string, body: string) — Registrar EVENTO de documento fiscal no Bsoft (CT-e ou MDF-e): cancelamento, carta de correção, encerramento etc. ⚠️ Ação fiscal real em PRODUÇÃO.
- bsoft_financeiro(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Financeiro no Bsoft TMS (leitura). Títulos a pagar/receber, pagamentos, recebimentos, contas financeiras, contratos, centros de custo, planos de contas, conciliação e transferências.
- bsoft_financeiro_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Financeiro no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_financeiro_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Financeiro no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_financeiro_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Financeiro no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_financeiro_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Financeiro no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_financeiro_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Financeiro no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_list_accounts(account?: string) — Lista os tenants (domínios) Bsoft conectados a este install — id, label e domínio.
- bsoft_manutencao(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Manutenção / Frota no Bsoft TMS (leitura). Abastecimentos, pneus, equipamentos, ordens de serviço de manutenção e tabelas de referência (combustíveis, marcas, modelos).
- bsoft_manutencao_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Manutenção / Frota no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_manutencao_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Manutenção / Frota no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_manutencao_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Manutenção / Frota no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_manutencao_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Manutenção / Frota no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_manutencao_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Manutenção / Frota no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_os(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Ordem de Serviço no Bsoft TMS (leitura). Ordens de serviço (leitura, agendamentos, históricos, materiais, produtos/serviços) e ações; categorias, status e tipos.
- bsoft_os_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Ordem de Serviço no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_os_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Ordem de Serviço no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_os_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Ordem de Serviço no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_os_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Ordem de Serviço no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_os_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Ordem de Serviço no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_pessoas(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Pessoas no Bsoft TMS (leitura). Cadastro de pessoas físicas e jurídicas (clientes, motoristas, fornecedores), endereços, contatos, contas de depósito, arquivos e grupos.
- bsoft_pessoas_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Pessoas no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_pessoas_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Pessoas no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_pessoas_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Pessoas no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_pessoas_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Pessoas no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_pessoas_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Pessoas no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_recursos(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Recursos (usuários do sistema) no Bsoft TMS (leitura). Usuários/recursos do Bsoft: listar, grupos, inatividades, IPs de acesso, ativar/inativar.
- bsoft_recursos_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Recursos (usuários do sistema) no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_recursos_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Recursos (usuários do sistema) no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_recursos_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Recursos (usuários do sistema) no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_recursos_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Recursos (usuários do sistema) no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_recursos_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Recursos (usuários do sistema) no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_transporte(account?: string, resource: string, id?: string, parent_id?: string, offset?: integer, limit?: integer, query?: string, ids?: string[], parent_ids?: string[]) — Transporte no Bsoft TMS (leitura). CT-e (conhecimentos), MDF-e (manifestos), veículos, agências, apólices, fretes/contratos, ocorrências, pedidos, ordens de carregamento e tabelas de referência.
- bsoft_transporte_write_create(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Transporte no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_transporte_write_create_lote(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Transporte no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_transporte_write_delete(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Transporte no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_transporte_write_patch(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Transporte no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).
- bsoft_transporte_write_update(account?: string, resource: string, id?: string, parent_id?: string, body?: string, ids?: string[], parent_ids?: string[]) — Transporte no Bsoft TMS (escrita: cria/atualiza/remove). ⚠️ Altera dados de PRODUÇÃO (o Bsoft não tem homologação).

## Example prompts
- "List the CT-e issued this month and bring me their access keys"
- "Which payables are due this week in finance?"
- "Show the open trips and the drivers' advances"

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