Tavily MCP MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Quatro ferramentas MCP: pesquisar, extrair, mapear, rastrear – resultados formatados em LLM
Latência e confiabilidade de nível de produção (não um hack de raspagem)
Retorna URLs de origem com cada snippet – respostas citáveis por padrão
Nível gratuito (1.000 chamadas de API/mês); níveis pagos para maior volume
Funciona de forma independente, sem navegador, sem proxy, sem dança anti-bot

Demo ao vivo

Como fica na prática

tavily-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "tavily-mcp",
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "tavily-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "tavily-mcp@latest"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add tavily-mcp -- npx -y tavily-mcp@latest

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Tavily MCP

Responder a uma pergunta sobre algo que aconteceu após o corte do modelo

👤 Qualquer pessoa que use o Claude com perguntas que precisem de informações atualizadas ⏱ ~5 min beginner

Quando usar: Você pergunta sobre um lançamento de 2026, um CVE recente, uma nova página de preços ou o mercado atual – o modelo não sabe e deve procurar.

Pré-requisitos

Chave API Tavily — Inscreva-se em tavily.com (nível gratuito = 1.000 chamadas/mês)
Tavily MCP instalado — Cole o bloco de configuração acima nas configurações MCP do seu cliente

Fluxo

Pergunte diretamente

O que a Anthropic enviou no Claude Sonnet 4.7 este mês? Use Tavily para encontrar o anúncio e resumir com as fontes.✓ Copiado

→ Agente chama tavily_search, retorna um resumo com fontes vinculadas
Aprofunde-se em uma fonte

A segunda fonte parece mais confiável - use tavily_extract para obter o texto completo e citar a linha exata sobre a janela de contexto.✓ Copiado

→ Citação direta com URL + número do parágrafo

Resultado: Resposta atual citada de uma só vez - sem pesquisa manual no Google.

Armadilhas

A pesquisa retornou lixo de SEO primeiro — Adicione dicas do site: '... de anthropic.com ou do blog oficial da anthropic'
Resumos derivam das fontes — Exigir citações diretas - 'paráfrase, mas preserve números, datas e nomes com exatidão'

Combine com: filesystem · memory

Faça uma análise de produto competitivo em uma sessão

👤 PMs, fundadores, profissionais de marketing ⏱ ~30 min intermediate

Quando usar: Você precisa de um resumo de uma página sobre cada concorrente para uma determinada categoria de recursos até o final do dia.

Fluxo

Descubra concorrentes

Usando Tavily, encontre os 8 principais produtos que competem conosco em 'CRM nativo de IA para pequenas e médias empresas'. Para cada um, retorne o nome, URL, one-liner, ano de fundação.✓ Copiado

→ Tabela estruturada de 8 linhas com links de origem
Mapeie cada site

Para cada concorrente, tavily_map seu site para encontrar suas páginas de preços e recursos. Retorne os URLs.✓ Copiado

→ 2 URLs por concorrente
Extrair preços

tavily_extraia cada página de preços e crie uma grade de comparação: nome do plano, preço mensal, 3 principais diferenciais.✓ Copiado

→ Grade limpa; células citam o URL da página de preços

Resultado: Um resumo compartilhável com fontes – pronto para um slide do PMM em 30 minutos.

Armadilhas

O preço renderizado em JS e a extração não atendem — Volte para tavily_crawl com render=on ou acesse o mapa do site /pricing diretamente

Combine com: filesystem

Escreva um tutorial com links verificados ao vivo

👤 Escritores técnicos, DevRel ⏱ ~25 min intermediate

Quando usar: Você está publicando um tutorial e cada link externo deve direcionar para o conteúdo certo hoje.

Fluxo

Coletar referências de candidatos

Usando tavily_search, encontre as 5 principais páginas de documentos canônicos para 'Fluxo OAuth 2.1 PKCE'. Prefira RFCs e documentos de fornecedores a blogs.✓ Copiado

→ 5 URLs com uma breve justificativa cada
Verifique cada um

tavily_extract cada URL. Para cada um, confirme se a página ainda cobre o PKCE e sinalize qualquer um que pareça redirecionado ou obsoleto.✓ Copiado

→ Veredicto ao vivo por URL
Incorporar no rascunho

Reescreva meu rascunho do tutorial para citar apenas os URLs verificados, com texto âncora que corresponda ao título real da página.✓ Copiado

→ Rascunho atualizado; cada texto do link corresponde ao título real da página

Resultado: Tutorial publicado com zero links mortos e texto âncora preciso.

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

tavily-mcp + filesystem

Pesquise, extraia para o disco e analise localmente sem buscar novamente

Pesquise no Tavily as 10 principais fontes recentes do OWASP, extraia-as, salve em /research/owasp/ e compare o conteúdo off-line.✓ Copiado

tavily-mcp + memory

Crie um diário de pesquisa que persista entre as sessões

Para cada pesquisa no Tavily, salve uma nota de uma linha e os URLs na memória em 'project:acme'. Na próxima sessão, reutilize.✓ Copiado

tavily-mcp + context7

Tavily para contexto web + Context7 para documentos de biblioteca — não os confunda

Use o Context7 para perguntas sobre documentos; Tavily para notícias, postagens de blogs e qualquer coisa que não esteja nos índices da biblioteca.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
tavily_search	query: str, max_results?: int, search_depth?: 'basic'\|'advanced', include_domains?: str[]	Ferramenta primária – uma consulta, snippets prontos para LLM com URLs	1 API call
tavily_extract	urls: str[], extract_depth?: 'basic'\|'advanced'	Você já tem um URL e deseja um texto limpo – sem HTML, sem anúncios	1 API call per URL
tavily_map	url: str, max_depth?: int, categories?: str[]	Descubra a estrutura de um site – útil antes de extrair/rastrear	1 API call
tavily_crawl	url: str, max_depth?: int, limit?: int, instructions?: str	Ingestão ampla de um site pequeno ou seção de documentos – caro, prefira extrair quando você já conhece os URLs	Multiple API calls (one per page)

Custo e limites

O que custa rodar

Cota de API: Nível gratuito = 1.000 chamadas de API/mês; escalando planos a partir de US$ 30/mês
Tokens por chamada: Retorna cerca de 500 a 5.000 tokens de conteúdo limpo – muito menos do que o HTML bruto faria
Monetário: Free tier covers individual daily use; heavy workflows need paid
Dica: Prefer tavily_search over tavily_crawl — search is one call, crawl is N. Only crawl when you truly need breadth.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: TAVILY_API_KEY in env var (set in the MCP config's env block)

Saída de dados: Queries and URLs you pass are sent to api.tavily.com. Don't paste proprietary info into the query string.

API key goes to Anthropic's Claude Desktop config in plaintext. Use a key scoped to this use case; rotate if the config file is shared.
tavily_crawl can rack up calls fast — set a low limit unless you know the site size.

Solução de problemas

Erros comuns e correções

401 Unauthorized

Double-check TAVILY_API_KEY in your MCP config. The env block lives inside the server config, not at top level.

Verificar: Call any Tavily tool; if the error persists, rotate the key in tavily.com dashboard

Empty results despite a real query

Switch search_depth from 'basic' to 'advanced' for niche topics; add include_domains to bias toward authoritative sources

Verificar: Repeat with search_depth: 'advanced'

tavily_extract returns paywalled gibberish

Tavily follows robots.txt and respects paywalls. For paywalled content, note it's unreachable — don't try to bypass.

429 Rate limit

Free tier = 60 RPM. Space out calls, or upgrade at tavily.com. The MCP auto-backs-off once, then surfaces the error.

Verificar: Check usage in tavily.com dashboard

Alternativas

Tavily MCP vs. outros

Alternativa	Quando usar	Troca
exa-mcp-server	You want Exa's neural/embedding-style search and similarity	Different result quality on different query types; both are LLM-tuned
fetch	You have the URL and just want HTML → markdown, no search	No search; no structured extract; you handle the URL discovery
perplexity-ask	You want a research-level answer synthesized by Perplexity, not raw results	Higher latency, higher cost, less composable — it's one big tool
firecrawl-mcp-server	You need heavy crawling or JS rendering as a core workflow	Pricier; overkill for one-off lookups

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills