VATFind — VAT & EIN Lookup

npx add-mcp 'https://vatfind.com/api/mcp'

Dados empresariais para agentes de IA. Consulta de VAT e EIN via MCP.

Dê a um assistente de IA ferramentas para encontrar o número de VAT de uma empresa, validar um VAT ID ou EIN dos EUA fornecido e recuperar as evidências por trás do resultado. Conecte-se via OAuth e use o acesso a dados e créditos do seu workspace VATFind.

Como conectar um assistente de IA ao VATFind.

Um servidor MCP de dados empresariais expõe ferramentas de busca e recuperação de empresas a um cliente de IA através do Model Context Protocol. O VATFind fornece um endpoint remoto Streamable HTTP com autorização OAuth. O cliente descobre as ferramentas; o VATFind processa cada solicitação dentro do seu workspace.

URL DO SERVIDOR MCP https://vatfind.com/api/mcp

1. 01

   Abra as conexões do seu cliente

   Adicione um servidor MCP remoto personalizado em um cliente que suporte Streamable HTTP e descoberta OAuth. Use VATFind como nome da conexão.
2. 02

   Insira a URL do servidor

   Cole https://vatfind.com/api/mcp no campo de URL do servidor remoto. Use o endpoint acima em vez desta página do site.
3. 03

   Entre e autorize

   Siga a tela de login do VATFind, revise o cliente e as permissões solicitadas e aproveite os escopos necessários para seu fluxo de trabalho.
4. 04

   Inspecione as ferramentas disponíveis

   Verifique se as ferramentas aparecem e, em seguida, consulte as capacidades por país ou o uso do workspace. Execute uma consulta de empresa após confirmar acesso ativo e créditos.

Usando Claude ou outro cliente de IA?

A conexão exige suporte a MCP remoto, descoberta OAuth compatível e permissão do seu cliente ou administrador do workspace. Rótulos e disponibilidade dependem do cliente e do plano. O VATFind usa OAuth para MCP; você não cola uma chave de API REST ativa na conversa.

Faça uma pergunta específica. Obtenha evidências da empresa.

Use o nome da empresa e o país quando o ID fiscal estiver ausente. Use o número de VAT ou EIN dos EUA fornecido quando a tarefa for verificar a empresa associada. Dê ao agente contexto suficiente para distinguir um nome comercial, subsidiária e contraparte legal.

ENCONTRE UM NÚMERO DE VAT

Resolva a empresa primeiro

"Encontre o número de VAT para [nome legal da empresa] em [país]. Mostre os candidatos se a empresa for ambígua."

find_vat_number retorna candidatos de empresas. O agente deve compará-los antes de informar um identificador.

Fluxo de fundamentação da empresa →

VALIDE UM EIN DOS EUA

Verifique a identidade do fornecedor

"Valide este EIN dos EUA com o registro de empresa disponível. Compare o nome legal com nosso fornecedor e mostre o estado do resultado."

check_tax_identifier retorna a associação da empresa e estados de evidência separados.

Fluxo de consulta de EIN →

MONITORE UM FORNECEDOR

Revise alterações da empresa

"Crie um monitor semanal de registro de empresa para este fornecedor e mostre-me quaisquer alterações no nome, endereço ou status legal."

As ferramentas de monitoramento estabelecem uma linha de base e retornam eventos de alteração da empresa para revisão.

Monitoramento de empresas via MCP →

Esses prompts descrevem fluxos de trabalho, não resultados pré-computados. O cliente host controla o uso das ferramentas. Uma consulta pode retornar uma correspondência, vários candidatos, nenhuma correspondência ou uma fonte indisponível; a resposta informa ao agente qual resultado ocorreu.

Pesquise empresas, verifique identificadores e monitore alterações.

O acesso às ferramentas depende dos escopos OAuth concedidos à conexão. Comece com permissões de consulta e recuperação; adicione acesso de escrita para monitoramento quando o fluxo de trabalho precisar criar ou alterar uma programação.

Ferramenta	Escopo	Finalidade
check_vat_number	checks:run	Verificar formato de VAT e associação ao registro da empresa.
find_vat_number	companies:search	Encontrar candidatos de empresas a partir de nome ou número de registro.
check_tax_identifier	checks:run	Verificar um EIN dos EUA sem aplicar reivindicações de VAT.
get_check	checks:read	Recuperar um resultado anterior pelo ID da verificação.
get_country_capabilities	coverage:read	Ler formatos suportados e dimensões de verificação.
get_usage	usage:read	Ler o uso do período atual e a cota restante.
create_vat_monitor	monitoring:write	Criar uma linha de base paga e um monitor programado de registro de empresa.
list_vat_monitors	monitoring:read	Listar monitores, saúde, cadência e snapshots mais recentes.
get_vat_monitor	monitoring:read	Recuperar um monitor e seu estado de programação atual.
update_vat_monitor	monitoring:write	Pausar, retomar ou alterar cadência e campos monitorados.
run_vat_monitor	monitoring:write	Executar uma atualização de monitoramento sob demanda idempotente.
archive_vat_monitor	monitoring:write	Interromper verificações futuras mantendo as evidências de eventos.
list_vat_monitor_events	monitoring:events	Listar alterações materiais e eventos operacionais.
get_vat_monitor_event	monitoring:events	Recuperar um evento e seu estado de entrega.

As ferramentas de monitoramento mantêm vat_monitor em seus nomes para compatibilidade. Sua função atual é o monitoramento programado de registros de empresas. Elas não monitoram o status de registro de VAT ao vivo no VIES ou HMRC.

Dê ao agente um resultado que ele possa explicar.

O VATFind MCP retorna o mesmo modelo de evidências de empresa e verificação que a API REST, com um resumo em texto para clientes que precisam de um. Uma empresa retornada pode incluir nome legal, número de registro, país, números de VAT, identificadores fiscais, endereço registrado, status legal, fontes e timestamp de recuperação. Atributos opcionais dependem do registro.

Campo de resposta	Pergunta que responde	Como o agente deve usá-lo
format_status	O identificador segue o formato suportado?	Solicite um número corrigido quando sua estrutura for inválida.
registry_match_status	O identificador foi associado a uma empresa?	Informe o estado da correspondência; solicite esclarecimento para candidatos ambíguos.
tax_authority_status	Há um resultado de registro na autoridade?	Informe quando o status da autoridade não for suportado ou não for verificado.
company_legal_status	Qual é o estado legal da empresa retornada?	Mantenha o status da empresa separado do status de registro de VAT.
evidence[]	O que sustenta cada dimensão de evidência?	Retenha o contexto da fonte e o horário de recuperação ao explicar a resposta.
warnings / credits_used	Quais limites e uso se aplicam ao resultado?	Apresente limitações relevantes e acompanhe o custo do workspace.

O serviço atual não consulta sistemas ao vivo de autoridades fiscais. Um agente não deve descrever um registro de VAT como ativo nem afirmar uma correspondência de TIN do IRS apenas com base em evidências de registro de empresa.

Escolha como seu sistema solicitará dados empresariais.

Requisito	MCP	API REST
Chamador típico	Um assistente ou agente de IA compatível com MCP.	Seu aplicativo, serviço de backend ou job de integração.
Autenticação	Consentimento OAuth e tokens de acesso com escopo.	Chave de API bearer no servidor.
Descoberta de operações	O cliente descobre ferramentas tipadas.	Desenvolvedores usam documentação de API e OpenAPI.
Testes	Processamento ao vivo no workspace.	Fixtures de sandbox determinísticas ou solicitações ao vivo.
Evidências da empresa	Resultados de verificação estruturados com resumo em texto.	Respostas JSON estruturadas.

Ambas as interfaces usam o mesmo saldo de créditos ao vivo do workspace. Operações MCP faturáveis exigem acesso pago ativo e créditos disponíveis. Recuperação somente leitura, capacidades por país, eventos e uso não consomem um crédito de verificação. Um grande conjunto de dados inicial ou entrega recorrente de arquivos é tratado por um feed em lote com escopo separado.

Mantenha permissões e novas tentativas explícitas.

O VATFind usa fluxo de código de autorização com PKCE, tokens de curta duração vinculados a recursos e tokens de atualização rotativos. Cada chamada de ferramenta verifica seu escopo obrigatório. Um cliente deve reconectar quando precisar de permissões adicionais.

Chamadas faturáveis e mutáveis exigem um idempotency_key. Mantenha o mesmo valor ao tentar novamente a mesma operação. Trate limites de taxa e falhas temporárias de fonte antes de permitir um loop automático de novas tentativas.

Se a conexão falhar

401: reconecte para renovar a autenticação. 403: revise o escopo obrigatório. Se uma ferramenta estiver ausente, atualize o catálogo do cliente e verifique a documentação atual. Para uma resposta de pagamento obrigatório, inspecione o faturamento e os créditos do workspace.

Catálogo de ferramentas MCP e capacidades revisados em 8 de setembro de 2026.

Conecte um agente com uma compreensão clara dos dados.

Endpoint, OAuth, clientes, consulta de VAT e EIN, testes em sandbox e créditos do workspace.

O que é um servidor MCP de dados empresariais?

Um servidor MCP de dados empresariais expõe ferramentas de busca e recuperação de empresas a clientes de IA através do Model Context Protocol. O VATFind fornece ferramentas para descoberta de empresas, consulta de número de VAT, validação de EIN dos EUA, capacidades por país, uso e monitoramento de registros de empresas.

Qual é a URL do servidor MCP do VATFind?

O endpoint remoto é https://vatfind.com/api/mcp.. Adicione essa URL exata como um servidor MCP remoto Streamable HTTP em um cliente compatível e conclua o login e a autorização OAuth do VATFind.

Como conecto o VATFind MCP a um assistente de IA?

Adicione uma conexão MCP remota personalizada, insira a URL do servidor VATFind e siga a tela de login e consentimento OAuth. Confirme que as ferramentas aparecem antes de executar uma consulta. O cliente deve suportar HTTP remoto e descoberta OAuth; rótulos de menu e disponibilidade variam.

Posso usar dados empresariais do VATFind no Claude?

Use um cliente Claude ou configuração de workspace que suporte uma conexão MCP remota compatível e descoberta OAuth do VATFind. Adicione a URL do servidor VATFind e autorize os escopos necessários. Verifique a versão do cliente, o plano e as configurações do administrador; a compatibilidade não é estabelecida abrindo a URL em um navegador.

Um agente de IA pode encontrar um número de VAT ou validar um EIN?

Sim, quando os dados empresariais relevantes estiverem disponíveis. find_vat_number pesquisa candidatos de empresas; check_vat_number verifica a associação de um identificador de VAT; check_tax_identifier verifica um EIN dos EUA. O agente deve informar o estado da correspondência retornado e solicitar esclarecimento quando os resultados forem ambíguos.

Preciso fornecer minha chave de API REST ao agente de IA?

Não. O VATFind MCP usa OAuth com tokens vinculados a recursos e com escopo. Conclua o fluxo de login e consentimento através do cliente em vez de colar uma chave de API REST ativa em um prompt.