Overview

This skill guides configuring Tavily MCP via Tavily Tools to resolve common start-up problems. It covers issues like API key invalid, web search not working, and Tavily failures, and it explains how to disable Tavily if it's not needed.

How This Skill Works

Run the command /tavily-tools:setup to configure Tavily MCP. The setup includes quick fixes for API key problems, quota limits, and connectivity issues, plus guidance to disable Tavily via the mcp command when needed.

When to Use It

• When you encounter Tavily MCP error or Tavily failed
• When the Tavily API key is invalid
• When web search via Tavily is not working
• When Tavily integration needs configuration or re-setup
• When you want to disable Tavily to prevent errors

Quick Start

1. Step 1: Run /tavily-tools:setup to configure Tavily MCP.
2. Step 2: If API key invalid, fetch a new key from app.tavily.com (format tvly-...).
3. Step 3: If issues persist, review quota and restart Claude Code after changes.

Best Practices

• Use a valid API key from app.tavily.com (format tvly-...)
• Be aware of the free quota: 1,000 searches per month
• After changing config, restart Claude Code to apply changes
• If you don't need Tavily, disable it with /mcp to avoid errors
• Test the integration after setup with a quick search

Example Use Cases

• User sees API key invalid and runs setup to refresh the key
• Quota exceeded warning leads to checking quota and adjusting usage
• Web search stops working due to misconfiguration; user reconfigures
• Connection failure fixed by restarting Claude Code after changes
• User temporarily disables Tavily with /mcp for a project

Frequently Asked Questions