Servidor MCP para IAs

// Listar cards ativos
{ "name": "goal_agent_list", "arguments": { "status": "active", "limit": 10 } }

// Consultar pelo nome
{ "name": "goal_agent_get", "arguments": { "name": "Atendimento N1" } }

// Inativar
{ "name": "goal_agent_inactivate", "arguments": { "goal_agent_id": "uuid-do-card" } }

// Criar orçamento
{ "name": "voxcard_sale_create", "arguments": {
  "type": "orcamento",
  "client_name": "Maria Silva",
  "phone": "11999998888",
  "items": [{ "name": "Filtro de óleo", "quantity": 1, "unit_price": 45.90 }]
} }

// Criar venda a partir de texto ou áudio já transcrito
{ "name": "voxcard_sale_create", "arguments": {
  "type": "venda",
  "client_name": "Rogério Lembo",
  "vehicle": {
    "model": "Onix",
    "plate": "GBQ4654",
    "color": "Preta"
  },
  "items": [{
    "name": "Troca de pastilha de freio",
    "item_type": "service",
    "quantity": 2,
    "total_price": 200.00
  }],
  "phase": "preview"
} }

// Adicionar item na venda 756
{ "name": "voxcard_sale_add_items", "arguments": {
  "sale_number": 756,
  "items": [{ "product_uid": "uuid-do-produto", "quantity": 2 }]
} }

// Registrar pagamento e finalizar
{ "name": "voxcard_sale_set_payments", "arguments": {
  "sale_number": 756,
  "payments": [{ "method": "Pix", "amount": 150.00, "received": true }],
  "finalize": true
} }

// Converter orçamento em venda
{ "name": "voxcard_sale_convert_budget", "arguments": { "sale_number": 1024 } }

// PDF comercial para impressão
{ "name": "voxcard_sale_document_download", "arguments": { "sale_number": 756 } }

// Enviar mensagem ao WhatsApp do cliente da venda
{ "name": "voxcard_sale_whatsapp_send_message", "arguments": {
  "sale_number": 756,
  "message": "Seu pedido está pronto."
} }

// Enviar mensagem direta, sem venda vinculada
{ "name": "voxcard_whatsapp_send_message", "arguments": {
  "recipient_uid": "uuid-do-cliente-ou-contato",
  "recipient_name": "Leandro",
  "destination_phone": "5511999990001",
  "message": "Verifique o sistema, por favor."
} }

// Depois de gerar o PDF acima, enviar o download_url retornado
{ "name": "voxcard_sale_document_whatsapp_send", "arguments": {
  "sale_number": 756,
  "document_url": "https://www.sysauto.com.br/api/mcp/documents/TOKEN_RETORNADO",
  "caption": "Segue o PDF do seu pedido.",
  "destination_phone": "5511952911872"
} }

// PDF da NF-e autorizada (download_url publico, sem login, validade limitada)
{ "name": "voxcard_sale_invoice_download", "arguments": { "sale_number": 756, "format": "both" } }

// Enviar DANFE/XML ao cliente com o download_url retornado
{ "name": "voxcard_sale_document_whatsapp_send", "arguments": {
  "sale_number": 756,
  "document_url": "https://www.sysauto.com.br/api/mcp/documents/TOKEN_DA_NFE",
  "caption": "Segue o DANFE da NF-e."
} }

// Emitir NFS-e no Emissor Nacional
{ "name": "voxcard_sale_emit_nfse", "arguments": {
  "sale_number": 756,
  "service_description": "Desenvolvimento de Sistemas\\nCompetência: 01/07/2026 a 31/07/2026",
  "competence_date": "2026-07-31",
  "national_tax_code": "010201",
  "nbs_code": "115029000",
  "city_code": "3550308",
  "service_amount": 10000.00,
  "phase": "preview"
} }

{ "name": "document_to_markdown", "arguments": {
  "document_base64": "BASE64_DO_ARQUIVO",
  "filename": "documento.pdf",
  "mime_type": "application/pdf"
} }

// Conferir a compra depois da importação
{ "name": "purchase_list", "arguments": { "limit": 10 } }
{ "name": "purchase_get", "arguments": { "purchase_number": 1 } }
{ "name": "purchase_get", "arguments": { "purchase_uid": "uuid-da-compra" } }

// Mercadoria chegou: marcar como recebido
{ "name": "purchase_receive", "arguments": { "purchase_number": 12, "phase": "preview" } }
{ "name": "purchase_receive", "arguments": { "phase": "commit", "confirmation_token": "token-retornado-no-preview" } }

// 1. Analisar o documento
{ "name": "purchase_receipt_analyze", "arguments": {
  "document_base64": "BASE64_DO_PDF_OU_XML",
  "mime_type": "application/pdf",
  "filename": "recibo.pdf"
} }

// 2. Preparar a importação com o document_uid retornado
// (sem document_uid/XML/base64 o preview retorna ready=false e não cria pending)
{ "name": "purchase_receipt_import", "arguments": {
  "document_uid": "uuid-temporario",
  "received": false,
  "paid": true,
  "payment_date": "2026-08-07",
  "phase": "preview"
} }

// 3. Após confirmação explícita
{ "name": "purchase_receipt_import", "arguments": {
  "phase": "commit",
  "confirmation_token": "token-retornado-no-preview"
} }

// 4. Consultar autorização da NF-e de entrada (não use voxcard_sale_*)
{ "name": "purchase_entry_invoice_get", "arguments": { "purchase_number": 1 } }
{ "name": "purchase_entry_invoice_get", "arguments": { "invoice_uid": "uuid-da-nfe-de-entrada" } }

// Preparar PIX para um cliente
{ "name": "finance_pix_generate", "arguments": {
  "q": "Leandro",
  "amount": 150,
  "phase": "preview"
} }

// Depois da confirmação explícita
{ "name": "finance_pix_generate", "arguments": {
  "phase": "commit",
  "confirmation_token": "token-retornado-no-preview"
} }

// Consultar contas a pagar vencidas
{ "name": "finance_list", "arguments": {
  "type": "pay", "status": "PENDENTE", "due_to": "2026-08-17"
} }

// Preparar baixa
{ "name": "finance_liquidate", "arguments": {
  "finance_uid": "uuid-da-conta",
  "payment_method_uid": "uuid-da-forma",
  "phase": "preview"
} }

// Depois da confirmação explícita
{ "name": "finance_liquidate", "arguments": {
  "phase": "commit",
  "confirmation_token": "token-retornado-no-preview"
} }

// Exemplo: cadastrar contato WhatsApp
{ "name": "contact_create", "arguments": { "name": "Gabi gol", "phone": "1195291873" } }

// Exemplo: filtrar por nome
{ "name": "contact_filter", "arguments": { "name": "Maria" } }

// Exemplo: filtrar por observação
{ "name": "contact_filter", "arguments": { "observation": "cliente vip" } }

// Exemplo: nome + observação (refina o resultado)
{ "name": "contact_filter", "arguments": { "name": "Maria", "observation": "orçamento" } }

// Exemplo: listar clientes
{ "name": "client_list", "arguments": { "limit": 10 } }

// Exemplo: buscar por nome
{ "name": "client_search", "arguments": { "q": "Oficina Central" } }

// Exemplo: buscar por documento
{ "name": "client_search", "arguments": { "document": "12345678901" } }

// Exemplo: obter pelo UID
{ "name": "client_get", "arguments": { "client_uid": "uuid-do-cliente" } }

// Exemplo: cadastrar cliente
{ "name": "client_create", "arguments": { "name": "Oficina Central", "phone": "11999998888" } }

// Exemplo: cadastrar colaborador/mecânico
{ "name": "employee_create", "arguments": { "name": "João Mecânico", "hiring_type": "CLT", "document": "12345678901", "mechanic_commission": "10", "mechanic_commission_type": "%" } }

// Exemplo: atualizar fornecedor (não use client_update)
{ "name": "supplier_get", "arguments": { "supplier_uid": "uuid-do-fornecedor" } }
{ "name": "supplier_update", "arguments": { "supplier_uid": "uuid-do-fornecedor", "cep": "13574360", "number": "697" } }

// Exemplo: consultar CEP (ViaCEP)
{ "name": "cep_lookup", "arguments": { "cep": "01001000" } }

// Exemplo: corrigir endereço do fornecedor da compra (preview)
{ "name": "person_update_address", "arguments": { "purchase_uid": "uuid-da-compra", "person_type": "supplier", "cep": "01001000", "number": "100", "phase": "preview" } }

// Exemplo: ViaCEP veio errado — sobrepor rua e bairro
{ "name": "person_update_address", "arguments": { "person_uid": "uuid-da-pessoa", "cep": "01001000", "number": "100", "street": "Rua Correta", "neighborhood": "Centro", "phase": "preview" } }

// Exemplo: atualizar o WhatsApp do fornecedor da compra (preview)
{ "name": "person_update_whatsapp", "arguments": { "purchase_uid": "uuid-da-compra", "person_type": "supplier", "whatsapp": "11952911872", "phase": "preview" } }