looot

npx add-mcp 'https://api.looot.ai/mcp'

looot MCP

looot é um gateway para cerca de 2.500 operações de provedores de dados: verificação e busca de e-mails, enriquecimento de empresas, dados de SEO e SERP, perfis sociais, web scraping e muito mais. Um token, um saldo pré-pago, um contrato de execução.

Instalação para agentes

claude mcp add --transport http looot https://api.looot.ai/mcp

Veja também: awesome-looot-use-cases (receitas de copiar e colar) e awesome-gtm (ferramentas GTM de código aberto).

O servidor está hospedado em https://api.looot.ai/mcp (HTTP streamable). A maioria dos clientes se conecta diretamente e faz login pelo navegador. Este repositório adiciona duas coisas:

• looot-mcp, um pequeno binário npm que faz a ponte entre stdio e o servidor hospedado, para clientes que só falam stdio. Ele executa uma versão fixa do mcp-remote (0.14.3) e não adiciona mais nada.
• server.json, a entrada do Registro MCP (ai.looot/looot), remota primeiro.
• gemini-extension.json e GEMINI.md, a extensão do Gemini CLI (servidor remoto mais a skill looot como contexto).
• llms-install.md, etapas de configuração que um agente de IA como o Cline pode seguir por conta própria.

looot-mcp ainda não está no npm, então as linhas npx looot-mcp abaixo funcionam apenas após um lançamento. Toda configuração remota funciona hoje.

Instalação

Escolha seu cliente. Cada um se conecta ao servidor hospedado e abre um login no navegador na primeira vez. Para usar um token de agente, veja Autenticação.

Claude Code

claude mcp add --transport http looot https://api.looot.ai/mcp

Depois execute /mcp, escolha looot e selecione Autenticar.

Claude (conector claude.ai e Claude Desktop)

Configurações, Conectores, Adicionar conector personalizado. Nome looot, URL https://api.looot.ai/mcp. Conecte e faça login com sua conta looot na janela do navegador que abrir.

Cursor

Clique no botão Instalar no Cursor acima, ou adicione isto ao ~/.cursor/mcp.json:

{
  "mcpServers": {
    "looot": { "url": "https://api.looot.ai/mcp" }
  }
}

VS Code

Clique no botão Instalar no VS Code acima, ou execute:

code --add-mcp '{"name":"looot","type":"http","url":"https://api.looot.ai/mcp"}'

ou adicione ao .vscode/mcp.json:

{
  "servers": {
    "looot": { "type": "http", "url": "https://api.looot.ai/mcp" }
  }
}

Codex

codex mcp add looot --url https://api.looot.ai/mcp
codex mcp login looot

Ou em ~/.codex/config.toml:

[mcp_servers.looot]
url = "https://api.looot.ai/mcp"

Gemini CLI

Como extensão (adiciona o servidor e o guia de uso do looot):

gemini extensions install https://github.com/loootai/looot-mcp

Ou apenas o servidor:

gemini mcp add --transport http looot https://api.looot.ai/mcp

Ou em ~/.gemini/settings.json (httpUrl é a chave do Gemini para HTTP streamable):

{
  "mcpServers": {
    "looot": { "httpUrl": "https://api.looot.ai/mcp" }
  }
}

Depois /mcp auth looot dentro do Gemini CLI.

ChatGPT (modo desenvolvedor)

Configurações, Apps e Conectores, Configurações avançadas, ative o Modo desenvolvedor. Depois Crie, nome looot, URL do servidor MCP https://api.looot.ai/mcp, autenticação OAuth.

Ainda não testado de ponta a ponta com looot. A página pública looot.ai/agents/chatgpt ainda diz que este caminho não está ativo.

Windsurf

Em ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "looot": { "serverUrl": "https://api.looot.ai/mcp" }
  }
}

Qualquer cliente somente stdio

{
  "mcpServers": {
    "looot": { "command": "npx", "args": ["-y", "looot-mcp@0.1.0"] }
  }
}

Até que looot-mcp esteja no npm, a mesma ponte funciona diretamente do mcp-remote:

{
  "mcpServers": {
    "looot": {
      "command": "npx",
      "args": ["-y", "mcp-remote@0.14.3", "https://api.looot.ai/mcp", "--transport", "http-only"]
    }
  }
}

Início rápido em 60 segundos

1. Adicione o servidor com uma das configurações acima e faça login.
2. Pergunte ao seu agente: "Use looot catalog_overview com tópico email, depois encontre a forma mais barata de verificar um e-mail." A navegação é gratuita.
3. Recarregue antes da primeira execução paga. A ferramenta balance retorna o mínimo e um link de pagamento; novos workspaces começam com $0 e não há crédito de teste.
4. Pergunte: "Execute job:people.email.verify em jane.doe@example.com com fallback." O agente chama run, e o resultado traz o preço efetivamente cobrado.

Ferramentas

O servidor hospedado lista estas ferramentas (fonte: api.looot.ai/llms.txt):

Ferramenta	O que faz	Custo
catalog_overview	categorias, plataformas e jobs com contagens e preços mais baratos	grátis
search_catalog, search, discover	encontra endpoints para um job, classificados por prefer	grátis
discover_smart	classifica uma lista curta contra um caso de uso em linguagem simples	pequena chamada de IA paga
inspect	esquema de entrada e saída, fórmula de preço, custo máximo estimado	grátis
run	retém o custo estimado, executa, liquida; aceita job:<id> e fallback	pago
runs_get, runs_list, runs_cancel, runs_evidence	status de execução, histórico, cancelamento, recibos por tentativa	grátis
balance, top_up	saldo e um link de pagamento Stripe	grátis
my_tools, capability_request	ferramentas de workspace, peça um job ausente	grátis

Autenticação

O login pelo navegador (OAuth) é o padrão. O servidor responde a uma chamada não autenticada com 401 e WWW-Authenticate: Bearer resource_metadata=..., e todos os clientes acima seguem isso.

Para agentes headless, crie um token de agente em looot.ai (Configurações, Tokens de agente) com pelo menos catalog.read, runs.read e runs.execute, depois exporte:

export LOOOT_TOKEN=cs_ms_...   # shown once, never commit it

• looot-mcp captura LOOOT_TOKEN e o envia como cabeçalho bearer. O token fica fora da lista de processos: a ponte passa Authorization:Bearer ${LOOOT_TOKEN} e o mcp-remote o expande a partir do próprio ambiente.
• Claude Code: adicione --header "Authorization: Bearer $LOOOT_TOKEN" à linha claude mcp add.
• Codex: adicione bearer_token_env_var = "LOOOT_TOKEN" em [mcp_servers.looot].

Desenvolvimento

npm install --ignore-scripts
npm test            # unit tests, offline
npm run test:live   # free public routes only: /.well-known/mcp.json and the OAuth metadata
npm run scan        # leak scanner, also run by the pre-commit hook
git config core.hooksPath .githooks

Links

• Site: https://looot.ai
• Guia do agente: https://api.looot.ai/llms.txt (completo: https://api.looot.ai/llms-full.txt)
• OpenAPI: https://api.looot.ai/openapi.json
• Descritor MCP: https://api.looot.ai/.well-known/mcp.json
• Páginas por cliente: https://looot.ai/agents.md
• Guia de instalação para agentes: llms-install.md

Licença

MIT, veja LICENSE. O serviço hospedado looot tem seus próprios termos: https://looot.ai/terms