Skip to main content
command CX Codex

setup · fcakyon — Claude Code command: what it does, how to install

setup configures Tavily MCP server credentials inside Claude Code and saves them to the plugin configuration.

Apache-2.0 ★ 1,216 updated 2026-10-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install tavily-tools@claude-settings
Open on GitHub

What setup does

The command inspects ${CLAUDE_PLUGIN_ROOT}/.mcp.json to verify the state of Tavily credentials. If the tavily.env.TAVILY_API_KEY field holds REPLACE_WITH_TAVILY_API_KEY, the script prompts for a key using AskUserQuestion. When an existing key starting with tvly- is already present, it confirms the server is set up.

Before modifying any files, the script validates user input: the key must start with tvly- and contain at least 20 characters. It then creates a backup file at ${CLAUDE_PLUGIN_ROOT}/.mcp.json.backup before writing the actual credential to .mcp.json.

Changes remain inactive until you restart Claude Code. You have to exit the active session, launch claude again, and verify the connection status using /mcp.

What it helps with

  • configure Tavily MCP in Claude Code without manually editing JSON files
  • validate Tavily API key format and length before saving
  • create a backup copy of .mcp.json before writing new credentials

Example prompts for the agent

  • /tavily-tools:setup
  • Run /tavily-tools:setup to configure the Tavily search API key

How to install setup

1Plugin marketplace

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install tavily-tools@claude-settings

2Manually: put the files in place

.claude/commands/setup.md

Call it with /setup. For all projects use ~/.claude/commands/

Questions about setup

How to install setup in Claude Code?

Run both marketplace commands in order: /plugin marketplace add fcakyon/claude-codex-settings, followed by /plugin install tavily-tools@claude-settings.

What does the setup command do?

It checks your current MCP configuration, validates the Tavily key format, creates a backup file, and saves the credential into .mcp.json.

Why is Tavily MCP unavailable immediately after setup?

Claude Code loads MCP configurations on startup. Exit Claude Code, run claude again, and confirm the server state with /mcp.

Source text

setup.md · Apache-2.0
---
description: Configure Tavily MCP server credentials
---

# Tavily Tools Setup

**Source:** [tavily-ai/tavily-mcp](https://github.com/tavily-ai/tavily-mcp)

Configure the Tavily MCP server with your API key.

## Step 1: Check Current Status

Read the MCP configuration from `${CLAUDE_PLUGIN_ROOT}/.mcp.json`.

Check if Tavily is configured:

- If `tavily.env.TAVILY_API_KEY` contains `REPLACE_WITH_TAVILY_API_KEY`, it needs configuration
- If it contains a value starting with `tvly-`, already configured

Report status:

- "Tavily MCP is not configured - needs an API key"
- OR "Tavily MCP is already configured"

## Step 2: Show Setup Guide

Tell the user:

```
To configure Tavily MCP, you need a Tavily API key.

Quick steps:
1. Go to app.tavily.com and sign in
2. Navigate to API Keys
3. Create a new API key
4. Copy the key (starts with tvly-)

Free tier: 1,000 searches/month

Don't need Tavily MCP? Disable it via /mcp command.
```

## Step 3: Ask for Key

Use AskUserQuestion:

- question: "Do you have your Tavily API key ready?"
- header: "Tavily Key"
- options:
  - label: "Yes, I have it"
    description: "I have my Tavily API key ready to paste"
  - label: "No, skip for now"
    description: "I'll configure it later"

If user selects "No, skip for now":

- Tell them they can run `/tavily-tools:setup` again when ready
- Remind them they can disable Tavily MCP via `/mcp` if not needed
- Exit

If user selects "Yes" or provides key via "Other":

- If they provided key in "Other" response, use that
- Otherwise, ask them to paste the key

## Step 4: Validate Key

Validate the provided key:

- Must start with `tvly-`
- Must be at least 20 characters

If invalid:

- Show error: "Invalid key format. Tavily keys start with 'tvly-'"
- Ask if they want to try again or skip

## Step 5: Update Configuration

1. Read current `${CLAUDE_PLUGIN_ROOT}/.mcp.json`
2. Create backup at `${CLAUDE_PLUGIN_ROOT}/.mcp.json.backup`
3. Update `tavily.env.TAVILY_API_KEY` value to the actual key
4. Write updated configuration back to `${CLAUDE_PLUGIN_ROOT}/.mcp.json`

## Step 6: Confirm Success

Tell the user:

```
Tavily MCP configured successfully!

IMPORTANT: Restart Claude Code for changes to take effect.
- Exit Claude Code
- Run `claude` again

To verify after restart, run /mcp and check that 'tavily' server is connected.
```

© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

setup by other authors comes first.

setup official Anthropic A setup command for Claude Code that guides administrators through connecting the Claude Office add-in to their cloud infrastructure. CX Codex +1 ★ 41,441repo stars setup Pranay Yadav setup sets up ShipMate in the current project, prepares story and pipeline folders, then runs the first codebase scan. CX Codex +1 ★ 42,780repo stars setup Seth Hobson setup initializes Conductor project context through an interactive Q&A, generating foundational documentation for your product, tech stack, style guides, and workflow. CX Codex +1 ★ 42,780repo stars setup Composio setup configures the connect-apps plugin so Claude Code can trigger actions in external services like Gmail, Slack, and GitHub through Composio. CX Codex +1 ★ 2,003repo stars setup-api-key calesthio setup-api-key — a skill that checks whether an ElevenLabs API key is configured and working, then walks the user through obtaining and saving a new key if needed. CX Codex +1 1,200installs dd-account-setup datadog-labs The dd-account-setup Claude Code skill checks Datadog credentials and the account region. It runs before Datadog setup or instrumentation, and can address a 403 caused by a region mismatch. CX Codex +1 113installs fetcher fetcher-sh Shared payment and setup skill for fetcher.sh: API keys, credits, x402 micropayments and MCP server config. Meant to run before or alongside the per-service skills. CX Codex +1 4,700installs web-search 101-skills This skill gives your agent web search and content extraction through Tavily and Exa. Useful for research, fact-checking and RAG pipelines. CX Codex +1 130,800installs tavily-search tavily-ai tavily-search — a skill for Claude Code that enables web searching and data extraction from webpages. Use it to verify facts, read current news, and gather information beyond the model's training data. CX Codex +1 39,400installs tavily-best-practices tavily-ai The tavily-best-practices skill gives an agent guidance for Tavily web search, content extraction, site crawling, and research. Use it when adding current web data to an agent workflow or RAG system. CX Codex +1 21,100installs

From the same set113

The whole set →
list-performance-item-memo list-performance-item-memo — a rule for React list rows: split the item into primitive props so memo() can compare them shallowly and skip a render when nothing changed. CX Codex +1 ★ 1,216repo stars react-state-dispatcher react-state-dispatcher enforces functional dispatch updaters in React setState calls whenever state depends on current values. Prevents stale closures in callbacks. CX Codex +1 ★ 1,216repo stars setup Skill for Claude Code configures real integration testing and user QA journeys across project codebases. It triggers when asked to set up QA or generate end-to-end testing flows. CX Codex +1 ★ 1,216repo stars list-performance-inline-objects list-performance-inline-objects — a rule that prevents creating objects inside renderItem for props. Inline objects create new references on every render and break memoization. CX Codex +1 ★ 1,216repo stars bundle-analyzable-paths The bundle-analyzable-paths rule recommends making import and file paths statically analyzable. That keeps bundlers from treating a broad set of files as reachable. CX Codex +1 ★ 1,216repo stars list-performance-item-expensive The list-performance-item-expensive rule bans heavy list rows: data queries, extra hooks and React Context reads inside renderItem. CX Codex +1 ★ 1,216repo stars ui-image-gallery ui-image-gallery directs AI assistants to build image galleries using @nandorojo/galeria instead of custom modal popups. CX Codex +1 ★ 1,216repo stars rendering-resource-hints The rendering-resource-hints rule tells the agent when to call React DOM's resource-hint functions inside React components. It targets server components, letting the browser start fetching assets before the client even has the HTML. CX Codex +1 ★ 1,216repo stars

Project sponsors

Companies that keep this analytics open