fcakyon/claude-codex-settings
Overview
This skill configures and troubleshoots the Tavily integration used by my MCP/agent setup. It provides quick fixes for common Tavily errors, guides API key setup, and offers simple commands to enable, disable, or reset the integration. Use it to restore web search, fix authentication, and keep the agent's Tavily connection healthy.
How this skill works
The setup skill runs the Tavily MCP configuration flow and validates the Tavily API key and connection. It detects common failure modes (invalid key, quota issues, connection errors) and suggests exact remediation steps. It also exposes commands to disable Tavily when you want to avoid related errors or to restart the agent after config changes.
When to use it
- You see “Tavily MCP error” in logs or UI.
- You receive “Tavily API key invalid” or authentication failures.
- Web search or external lookups stop working for the agent.
- Tavily returns quota or connection/failure messages.
- You want to disable Tavily to prevent recurring errors while debugging.
Best practices
- Obtain a valid Tavily API key from app.tavily.com; keys start with tvly- and must be current.
- Check free-tier quota (1,000 searches/month) before blaming connectivity.
- After updating keys or settings, restart the agent (Claude Code) to apply changes.
- If you don’t need Tavily, disable it via the MCP command to avoid errors.
- Log and save timestamps of failures to correlate with quota or key rotations.
Example use cases
- Fixing an authentication failure by replacing an expired Tavily API key with a new tvly-... key.
- Troubleshooting why web search stopped returning results by checking quota and restarting the MCP agent.
- Temporarily disabling Tavily during diagnostics to confirm whether errors originate from the integration.
- Running /tavily-tools:setup after a configuration change to revalidate settings and restore connectivity.
- Responding to a quota exceeded alert by upgrading or limiting automated searches until next billing cycle.
FAQ
Log in to app.tavily.com and create or copy your API key; valid keys use the tvly- prefix.
What if I hit quota limits?
Free tier allows 1,000 searches/month. Reduce automated searches or upgrade your plan to restore full functionality.
Do I need to restart the agent after changing credentials?
Yes. Restart Claude Code (or the MCP server) after updating keys or config to ensure changes take effect.
6 skills
This skill helps you diagnose Tavily MCP errors and configure Tavily integration to restore API access and project connectivity.
This skill helps you locate academic papers across arxiv, PubMed, IEEE, Scopus, ACM, and Semantic Scholar to accelerate research.
This skill helps you search Slack messages efficiently and retrieve channel history using best practices and rate limit awareness.
This skill helps you create and manage Linear issues and sprint plans by applying issue-writing guidelines and workflow templates.
This skill automates and guides the PR workflow from branch setup to creating a well-documented pull request.
This skill helps you query and manage Azure resources such as storage, Key Vault, Cosmos DB, and AKS using MCP best practices.
