FirmLens

npx add-mcp 'https://mcp.firmlens.io/mcp'

O servidor MCP FirmLens

Peça ao Claude para "encontrar instaladores solares na Alemanha que fazem trabalho EPC" e receba empresas reais de volta, com seus projetos e detalhes. O servidor MCP FirmLens conecta o Claude, o ChatGPT ou qualquer outro cliente MCP aos nossos diretórios, para que seu agente possa pesquisar empresas, filtrá-las por área e ler seus sites rastreados dentro de uma conversa.

Endereço do servidor

Aponte seu cliente para o endpoint HTTP Streamable:

https://mcp.firmlens.io/mcp

Clientes que só falam com o transporte SSE mais antigo podem se conectar a https://mcp.firmlens.io/sse.

Entre ou use uma chave de API

Há duas maneiras de se conectar. Ambas usam sua conta gratuita FirmLens e seus créditos.

Entre com sua conta FirmLens. Clientes que suportam login MCP, como Claude e ChatGPT, só precisam do endereço do servidor. Ao adicioná-lo, eles abrem uma página de login da FirmLens onde você entra com seu e-mail e senha habituais e aprova a conexão. Não há nada para copiar ou colar, e sua chave de API nunca sai da FirmLens. Sua conta precisa de um e-mail verificado.

Cada aplicativo que você conecta dessa forma aparece em Aplicativos conectados na sua página de conta. Desconecte um lá e ele perde o acesso imediatamente. Redefinir sua senha desconecta todos eles.

Ou passe sua chave de API como cabeçalho. Para Claude Code, seus próprios agentes e qualquer cliente sem login, envie sua chave de API FirmLens com cada requisição no cabeçalho x-api-key. O servidor não a armazena; ele a repassa para a API FirmLens.

x-api-key: YOUR_FIRMLENS_API_KEY

Se seu cliente só consegue enviar um token bearer, isso também funciona:

Authorization: Bearer YOUR_FIRMLENS_API_KEY

Toda conta FirmLens verificada vem com uma chave de API. Encontre a sua na página de conta; ainda não tem conta? Crie uma gratuitamente.

Trate a chave como uma senha. Mantenha-a na configuração do seu cliente e não a cole em um prompt ou em um arquivo compartilhado. Uma requisição sem login nem chave é recusada com 401 Unauthorized.

Conecte seu agente

Claude (claude.ai e o aplicativo de desktop): abra Configurações, depois Conectores, e escolha Adicionar conector personalizado. Digite https://mcp.firmlens.io/mcp e entre com sua conta FirmLens quando solicitado.

ChatGPT: abra Configurações, depois Apps e Conectores, e em Configurações avançadas ative o Modo desenvolvedor. De volta em Apps e Conectores, escolha Criar, nomeie o conector FirmLens, digite https://mcp.firmlens.io/mcp como URL do servidor e escolha OAuth como autenticação. O ChatGPT então o envia para a FirmLens para entrar e aprovar. O Modo desenvolvedor depende do seu plano ChatGPT, e os nomes dos menus podem variar um pouco entre versões do ChatGPT.

Claude Code adiciona o servidor e seu cabeçalho em um único comando:

claude mcp add --transport http firmlens https://mcp.firmlens.io/mcp \
  --header "x-api-key: YOUR_FIRMLENS_API_KEY"

OpenAI Agents SDK e Responses API: a ferramenta MCP hospedada conecta com sua chave de API em um cabeçalho. Em Python:

from agents import Agent, HostedMCPTool

firmlens = HostedMCPTool(tool_config={
    "type": "mcp",
    "server_label": "firmlens",
    "server_url": "https://mcp.firmlens.io/mcp",
    "headers": {"x-api-key": "YOUR_FIRMLENS_API_KEY"},
    "require_approval": "never",
})

agent = Agent(name="Researcher", tools=[firmlens])

Outros clientes que leem uma configuração JSON aceitam uma entrada como esta. Onde a lista de servidores fica, e como suas chaves são chamadas, varia um pouco entre clientes, então verifique o seu. Se seu cliente suporta login MCP, deixe os cabeçalhos de fora e ele pedirá que você faça login:

{
  "mcpServers": {
    "firmlens": {
      "url": "https://mcp.firmlens.io/mcp",
      "headers": {
        "x-api-key": "YOUR_FIRMLENS_API_KEY"
      }
    }
  }
}

Uma vez conectado, pergunte ao seu agente algo como "Encontre instaladores solares na Alemanha que fazem trabalho EPC". Ele começa com list_directories para ver o que pode pesquisar.

Ferramentas

As buscas nos diretórios cobrem os diretórios de energia renovável, concessionárias de carros e segurança cibernética. Cada resultado carrega um refId que seu agente pode passar para web_cache_search_match para ler as páginas rastreadas daquela empresa.

Ferramenta	O que faz	Créditos
list_directories	Lista os diretórios que você pode pesquisar	Grátis
get_search_fields	Lista os campos pesquisáveis de um diretório	Grátis
get_stats	Sua cota restante e contagens de chamadas	Grátis
search	Busca de texto livre em todos os campos de um diretório	1 por resultado
search_match	Pesquisa campos específicos, opcionalmente como correspondência exata	1 por resultado
search_match_multiple	Uma consulta diferente por campo, todas devendo corresponder	1 por resultado
search_fields_exists	Empresas que têm dados nos campos fornecidos	1 por resultado

As ferramentas web funcionam em qualquer site rastreado, não apenas em empresas de diretórios:

Ferramenta	O que faz	Créditos
get_web_info	URL resolvida, endereços IP e data do último rastreamento de um site	1
get_web_data	Dados extraídos de um site, incluindo dados schema.org	1
web_cache_search	Busca de texto completo em páginas rastreadas	1
web_cache_search_match	Pesquisa um campo de página; com refId, as páginas rastreadas de uma empresa	1

Créditos e limites

Os créditos são cobrados na sua conta FirmLens, seja conectando-se com login ou com sua chave de API. As buscas nos diretórios custam 1 crédito por empresa retornada, então uma página de 3 empresas custa 3 créditos e uma página de 100 custa 100. Uma busca retorna até 100 empresas, e sua cota restante deve cobrir o tamanho de página que você solicitar. As ferramentas de dados web custam 1 crédito por chamada. Seu agente pode verificar sua cota restante gratuitamente com get_stats.

Está ficando sem créditos? Recarregue na sua página de conta. Os créditos são um pagamento único com cartão via Stripe, com IVA adicionado no checkout quando aplicável. Eles são adicionados ao seu saldo em menos de um minuto após o pagamento e não expiram.

Cada chave ou conta conectada pode fazer rajadas de até 60 requisições, reabastecidas a 2 por segundo. Além disso, o servidor responde com 429 Too Many Requests até que a permissão seja reabastecida.

Perguntas ou precisa de um limite maior? Entre em contato.