GoodVat MCP Server

GoodVat MCP Server

Um servidor Model Context Protocol (MCP) que dá a assistentes e agentes de IA acesso a conhecimento e ferramentas de conformidade tributária global — construído e mantido pela GoodVat.

Se você vende qualquer coisa, em qualquer lugar, este servidor responde às perguntas fiscais que surgem: alíquotas e regras de IVA na UE e no Reino Unido, imposto sobre vendas dos EUA por estado, GST da Índia, limites de registro, requisitos de faturamento e muito mais — além de ferramentas de consulta em tempo real para verificar IDs fiscais.

O que ele faz

• Guias fiscais e perguntas e respostas — faça perguntas em linguagem natural como "qual é a alíquota de IVA na França para bens digitais?" ou "preciso me registrar para o imposto sobre vendas na Califórnia?" e obtenha respostas precisas e com fontes, cobrindo:
  • IVA do Reino Unido
  • IVA da UE (todos os estados-membros)
  • Imposto sobre vendas dos EUA (estado por estado)
  • GST da Índia
  • mais jurisdições adicionadas regularmente
• Consulta de número de IVA (UE) — valida números de IVA da UE em tempo real por meio do registro oficial VIES.
• Consulta de número de IVA do Reino Unido (HMRC) — em breve.

Uso

O servidor MCP da GoodVat é hospedado remotamente via HTTP transmissível em:

https://api.goodvat.com/mcp

Opção 1: Conecte-se diretamente (HTTP remoto)

Se o seu cliente MCP suporta servidores remotos/HTTP nativamente (por exemplo, Claude.ai, conectores remotos do Claude Desktop, Cursor), aponte-o diretamente para a URL acima — sem necessidade de instalação.

{
  "mcpServers": {
    "goodvat": {
      "url": "https://api.goodvat.com/mcp"
    }
  }
}

Opção 2: Ponte stdio (este pacote)

Alguns clientes só suportam servidores MCP locais baseados em stdio. Este pacote (@goodvat/mcp-server) é uma ponte leve de stdio para HTTP: ele fala stdio com o seu cliente e encaminha cada mensagem para o endpoint remoto acima.

npx @goodvat/mcp-server

Adicione à configuração do servidor MCP do seu cliente:

{
  "mcpServers": {
    "goodvat": {
      "command": "npx",
      "args": ["@goodvat/mcp-server"]
    }
  }
}

Requisitos

• Node.js >= 18

Licença

MIT