Velora

Servidor MCP hospedado para comércio argentino — faturamento fiscal AFIP real + pagamentos MercadoPago (ao vivo), catálogo, vendas e WhatsApp; um endpoint público sem autenticação expõe 9 ferramentas de utilidade fiscal.

GitHubExperimente este MCPPatrocinado

Documentação

Este repositório contém o manifesto/documentação pública de um serviço hospedado — a implementação completa roda em produção como parte da Velora.

Velora — MCP de Comércio Argentino

⚠️ O endpoint hospedado está temporariamente offline. O serviço que ele atende está pausado, então tools.somosvelora.com retorna 404 agora — o manifesto e os contratos de ferramentas abaixo ainda estão precisos, mas as URLs não responderão até que volte. Nada aqui está abandonado; a documentação é mantida honesta de propósito.

Um kit de ferramentas de comércio hospedado e multi-capacidade para a Argentina — faturamento real AFIP, MercadoPago, logística, catálogo e WhatsApp atrás de um único endpoint autenticado.

Velora é um servidor hospedado Model Context Protocol que dá a agentes de IA ferramentas para operar comércio na Argentina: faturamento fiscal (AFIP/ARCA), pagamentos (MercadoPago), logística (Andreani / PedidosYa), catálogo, caixa registradora e mensagens WhatsApp — autenticado e isolado por tenant.

Existem outros servidores MCP da AFIP (alguns emitem faturas, outros apenas pesquisam a documentação). O diferencial da Velora é o pacote: o fiscal é um dos vários trilhos de comércio — pagamentos, logística, catálogo, mensagens — expostos através de um único endpoint hospedado e autenticado, para que um agente execute um negócio argentino inteiro, não apenas faturamento.

Endpoint

https://tools.somosvelora.com/api/mcp

Transporte: HTTP streamable. Autenticação: chave de API (HMAC por tenant) ou OAuth 2.1 (bearer do WorkOS). Qualquer cliente MCP — Claude, OpenAI, Gemini, Cursor, ou seu próprio agente — consome o mesmo endpoint.

Grátis durante o acesso antecipado. Sem custo de uso enquanto integramos os primeiros construtores — as ferramentas fiscais e puras não executam LLM do nosso lado, então permanece barato manter aberto.

Conectar

Aponte qualquer cliente MCP que suporte um servidor remoto streamable HTTP para o endpoint, com suas credenciais como cabeçalhos:

{
  "mcpServers": {
    "velora": {
      "type": "http",
      "url": "https://tools.somosvelora.com/api/mcp",
      "headers": {
        "X-API-Key": "<your-key>",
        "X-Business-Id": "<your-business-id>"
      }
    }
  }
}

A chave de configuração exata (type/transport) varia por cliente — use o formato de servidor MCP remoto/HTTP do seu cliente. Solicite acesso em somosvelora.com.

Os auxiliares fiscais puros (validate_cuit, split_iva, e o restante) também estão disponíveis sem autenticação em https://tools.somosvelora.com/api/mcp/public.

Pacotes de ferramentas

Pacote	O que faz
Fiscal (AFIP/ARCA)	`emit_invoice` (CAE real — Factura A/B/C + Consumidor Final), `consultar_comprobante` / `consultar_padron` (fatura + consulta de contribuinte), `get_fiscal_readiness`. `emit_nota` (NC/ND): somente sandbox hoje — emissão real de nota de crédito/débito em andamento.
Puro (sempre ativo)	`validate_cuit`, `validate_cuil`, `validate_cbu`, `build_afip_qr`, `format_ars`, `to_afip_date`, `split_iva`, `describe_invoice_type`, `parse_ar_amount`
Pagamentos	Links do MercadoPago, pagamentos rastreados, status de intenção de pagamento
Logística	cotação / criação / rastreamento de envios (Andreani, PedidosYa)
Catálogo e Estoque	criar / editar / excluir produtos, carga de estoque, atualização de preço em massa
Vendas e Caixa	registrar vendas, devoluções, movimentos de caixa e saldo
Clientes e Fornecedores	encontrar / upsert de clientes, gestão de fornecedores
Mensagens	envios de texto e template do WhatsApp
Relatórios	`query_sales` — análise de vendas
Conexão	`connection_status` — estado de configuração por integração (chame isso primeiro)

Maturidade / o que está ativo. emit_invoice (Factura A/B/C + Consumidor Final), as ferramentas de consulta e as ferramentas Puras são verificadas em produção contra a AFIP real. emit_nota (NC/ND) atualmente emite somente em sandbox — a emissão real de nota de crédito/débito ainda não está conectada (retorna sandbox: true, nunca um CAE falso). Pagamentos, Logística e Mensagens são ferramentas reais que exigem onboarding de credenciais por tenant (conecte MercadoPago / Andreani / WhatsApp) — até que um tenant as conecte, elas retornam dados de demonstração ou falham graciosamente, então não as integre a um fluxo de produção antes do onboarding. emit_invoice emite um CAE real somente após a conclusão do onboarding da ARCA (verifique com get_fiscal_readiness); caso contrário, retorna uma resposta de sandbox claramente sinalizada (sandbox: true), nunca um CAE falso apresentado como real.

Catálogo completo legível por máquina — liste todas as ferramentas com uma chamada tools/list contra o endpoint público (sem autenticação):

curl -s https://tools.somosvelora.com/api/mcp/public \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Por que uma camada gerenciada

Os serviços web da AFIP (WSAA + WSFE) são notoriamente dolorosos: assinatura CMS PKCS#7 anexada, handshakes TLS com DH fraco, gerenciamento de certificado e token por CUIT, e um fluxo de novas resoluções (ex.: RG 5616). A Velora absorve tudo isso por trás de chamadas de ferramentas limpas e nativas para agentes, para que você não precise reimplementar a pilha fiscal — a mesma razão pela qual desenvolvedores recorrem a camadas gerenciadas sobre APIs fiscais governamentais em outros lugares da LATAM.

Status

✅ Faturamento real AFIP verificado em produção (emissão de CAE ao vivo para um tenant integrado).
✅ Pagamentos MercadoPago e as ferramentas puras de validação/formatação estão ativos.
🔧 Logística e mensagens exigem onboarding de credenciais por tenant (veja Maturidade acima).

Links

Site: somosvelora.com
Endpoint do toolkit: tools.somosvelora.com
Blog (notas de campo da integração AFIP): somosvelora.com/blog — ⚠️ atualmente retorna 404 enquanto a rota /blog do site está fora

Este repositório é o manifesto público e a documentação do servidor MCP da Velora. O servidor em si é hospedado; este repositório contém o manifesto de registro server.json e a documentação de conexão.

Construído direcionando o Claude Code — escopado, gerado e verificado em tempo de execução. O método é o ponto — o mesmo por trás de 2 correções mescladas no Mastra (framework de agente de IA em TS com 26k★): #19604, #19610.