Saltar para o conteúdo principal
IVA na UE

Model Context Protocol

Servidor MCP de IVA da UE

Dê ao seu assistente de IA as taxas de IVA da UE em tempo real, cálculos de IVA, as próximas alterações de taxas e a verificação VIES de números de IVA. Gratuito, só de leitura e sem registo.

  • Streamable HTTP
  • Sem registo nem chave de API
  • Só de leitura

Ligue o seu cliente de IA

Escolha o seu cliente e siga os passos. Demora cerca de um minuto.

  1. 1

    No Claude, abra Settings → Connectors e escolha Add custom connector.

  2. 2

    Dê-lhe o nome EU VAT Info, cole o URL do servidor e selecione Add.

  3. 3

    Ative o EU VAT Info numa conversa a partir do menu de ferramentas e pergunte sobre o IVA.

  1. 1

    Execute este comando no terminal:

    Terminal

    claude mcp add --transport http eu-vat-info https://vat.businesspress.io/api/mcp
  2. 2

    Inicie o Claude Code e pergunte sobre o IVA. Escreva /mcp para verificar a ligação.

  1. 1

    Adicione isto a .vscode/mcp.json no seu projeto, ou execute MCP: Add Server na paleta de comandos e escolha HTTP.

    .vscode/mcp.json

    {
        "servers": {
            "eu-vat-info": {
                "type": "http",
                "url": "https://vat.businesspress.io/api/mcp"
            }
        }
    }
  2. 2

    Abra o Copilot Chat no modo agente e pergunte sobre o IVA.

  1. 1

    Adicione isto a ~/.cursor/mcp.json, ou a .cursor/mcp.json num projeto.

    mcp.json

    {
        "mcpServers": {
            "eu-vat-info": {
                "url": "https://vat.businesspress.io/api/mcp"
            }
        }
    }
  2. 2

    Confirme que o eu-vat-info está ativo em Cursor Settings → MCP e pergunte sobre o IVA no chat.

  1. 1

    Adicione o URL como servidor MCP remoto com Streamable HTTP e sem autenticação. A maioria dos clientes aceita esta configuração:

    JSON

    {
        "mcpServers": {
            "eu-vat-info": {
                "type": "http",
                "url": "https://vat.businesspress.io/api/mcp"
            }
        }
    }
  2. 2

    Os conectores do ChatGPT no modo de programador, o Windsurf, o Zed e outros clientes MCP ligam-se da mesma forma.

O que o seu assistente pode fazer

Seis ferramentas só de leitura. O seu assistente lê as descrições e escolhe a certa para cada pergunta.

  • Todas as taxas de IVA

    get_all_vat_rates

    Todas as taxas normais, reduzidas, super-reduzidas e parking da UE e de mais cinco países europeus.

    Parâmetros

    Sem parâmetros

    Experimente perguntar: Que país da UE tem a taxa normal de IVA mais baixa?

  • Taxas de um país

    get_country_vat_rate

    Taxas atuais, moeda e última atualização de um país.

    Parâmetros

    • country string · obrigatório

    Experimente perguntar: Quais são as taxas de IVA na Áustria?

  • Cálculo do IVA

    calculate_vat

    Acrescenta o IVA a um valor líquido ou retira-o de um valor bruto, com qualquer tipo de taxa.

    Parâmetros

    • amount number · obrigatório
    • country string · obrigatório
    • mode string · opcional
    • rate_type string · opcional

    Experimente perguntar: Quanto são 1250 euros mais o IVA alemão?

  • Comparação de taxas

    compare_vat_rates

    Taxas de dois a dez países lado a lado.

    Parâmetros

    • countries array · obrigatório

    Experimente perguntar: Compara o IVA em Espanha, Portugal e Itália.

  • Alterações de taxas

    get_vat_rate_changes

    Alterações de taxas registadas e previstas, com data de entrada em vigor e fonte.

    Parâmetros

    • country string · opcional
    • upcoming_only boolean · opcional
    • limit integer · opcional

    Experimente perguntar: Que taxas de IVA da UE vão mudar a seguir?

  • Verificação do número de IVA

    validate_vat_number

    Consulta o VIES

    Verifica um número de IVA no VIES e devolve o nome e a morada registados quando o Estado-Membro os publica.

    Parâmetros

    • country_code string · obrigatório
    • vat_number string · obrigatório

    Experimente perguntar: LT100019070512 é um número de IVA válido?

Experimente

Envie um pedido real ao servidor a partir do seu navegador.

POST /api/mcp

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2025-06-18",
        "capabilities": {},
        "clientInfo": {
            "name": "browser",
            "version": "1.0.0"
        }
    }
}

                        

A resposta aparecerá aqui.

Na linha de comandos

curl

curl -X POST https://vat.businesspress.io/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"calculate_vat","arguments":{"amount":100,"country":"DE","mode":"add"}}}'

Detalhes técnicos

Endpoint
https://vat.businesspress.io/api/mcp
Transporte
Streamable HTTP com respostas JSON
Versões do protocolo
2025-06-18, 2025-03-26, 2024-11-05
Autenticação
Nenhuma
Acesso
Só de leitura
Utilização justa
120 pedidos por minuto e por endereço IP, incluindo até 20 verificações de números de IVA
Dados
Taxas de IVA da Comissão Europeia, atualizadas diariamente

Perguntas

O que é o MCP?

O Model Context Protocol é uma norma aberta que permite aos assistentes de IA usar ferramentas e dados externos. Depois de ligado, o seu assistente consulta dados de IVA em tempo real em vez de confiar no que memorizou.

Preciso de uma conta ou de uma chave de API?

Não. O servidor é gratuito e não exige registo. Os limites de utilização justa mantêm-no rápido para todos.

É seguro ligá-lo?

Sim. Todas as ferramentas são só de leitura: o servidor devolve apenas dados e cálculos de IVA. Não consegue ver os seus ficheiros nem agir em seu nome.

As taxas estão atualizadas?

As taxas provêm de dados da Comissão Europeia e são atualizadas diariamente. Cada resultado indica quando o país foi atualizado pela última vez.

As respostas são aconselhamento fiscal?

Não. O servidor devolve taxas de referência. O tratamento correto do IVA depende dos bens ou serviços e do cliente, por isso confirme os casos importantes com um consultor fiscal ou com a autoridade tributária nacional.