Tavily Web Search MCP Server

Instructions

Implementation Reference

• tools/anthropic_tools.py:67-168 (handler)

  The core handler function for the 'ask_specialized_claude' tool. It validates inputs, selects the appropriate Claude profile, calls the Anthropic API with a specialized system prompt, formats the response, and handles errors.

  @mcp.tool(name="ask_specialized_claude")
  def ask_specialized_claude(
      prompt: str, 
      task_type: str = "general", 
      max_tokens: int = 1024
  ) -> str:
      """
      Call a specialized Claude model for targeted reasoning tasks.
      
      This is "meta-AI" - Claude in Cursor calling another Claude instance
      with specialized system prompts for specific tasks. Each task_type
      activates a different Claude persona optimized for that use case.
      
      Args:
          prompt: User input for Claude to process
          task_type: Specialization mode, one of:
              - code_review: Security and quality code analysis
              - summarize: Concise text summarization
              - explain: Educational explanations (ELI5 style)
              - creative: Creative writing and ideation
              - general: General-purpose assistance
          max_tokens: Response length cap (default 1024, max 4096)
      
      Returns:
          A formatted string response from the specialized Claude instance
          
      Examples:
          >>> ask_specialized_claude("Explain quantum computing", "explain")
          >>> ask_specialized_claude("Review this code: def foo()...", "code_review")
          >>> ask_specialized_claude("Summarize this article...", "summarize")
      
      Raises:
          ValueError: If task_type is not recognized
          Exception: If API call fails (network, auth, rate limit, etc.)
      """
      
      # Validate task_type
      if task_type not in CLAUDE_PROFILES:
          valid = ", ".join(CLAUDE_PROFILES.keys())
          raise ValueError(
              f"Invalid task_type '{task_type}'. Must be one of: {valid}"
          )
      
      # Validate max_tokens
      if not (1 <= max_tokens <= 4096):
          raise ValueError(
              f"max_tokens must be between 1 and 4096, got {max_tokens}"
          )
      
      # Get the profile for this task type
      profile = CLAUDE_PROFILES[task_type]
      
      # Get cached Anthropic client
      try:
          client = get_anthropic_client()
      except EnvironmentError as e:
          return f"❌ Configuration Error: {str(e)}"
      
      try:
          # Call Claude with specialized system prompt
          response = client.messages.create(
              model="claude-sonnet-4-20250514",  # Latest Claude model
              system=profile["system"],
              max_tokens=max_tokens,
              messages=[{"role": "user", "content": prompt}],
          )
          
          # Extract response text
          text = response.content[0].text.strip() if response.content else "[No content returned]"
          
          # Format with header showing which mode was used
          header = f"🤖 Specialized Claude ({task_type.replace('_', ' ').title()} Mode)"
          separator = "─" * len(header)
          
          return f"{header}\n{separator}\n\n{text}"
      
      except Exception as e:
          # Provide helpful error messages
          error_msg = str(e)
          
          # Check for common error types
          if "rate_limit" in error_msg.lower():
              return (
                  f"❌ Rate Limit Error: Too many requests to Claude API.\n"
                  f"Please wait a moment and try again."
              )
          elif "authentication" in error_msg.lower() or "api_key" in error_msg.lower():
              return (
                  f"❌ Authentication Error: Invalid ANTHROPIC_API_KEY.\n"
                  f"Please check your .env file and verify your API key."
              )
          elif "timeout" in error_msg.lower():
              return (
                  f"❌ Timeout Error: Request to Claude API timed out.\n"
                  f"Please try again."
              )
          else:
              return (
                  f"❌ Error invoking Claude ({task_type}): {error_msg}\n\n"
                  f"If this persists, check your API key and network connection."
              )

• tools/anthropic_tools.py:19-64 (schema)

  Schema defining the specialized Claude profiles, including system prompts and descriptions for each task_type. Used for input validation and to configure specialized behavior.

  # Declarative profile map - keeps logic clean and DRY
  # Each profile defines a specialized Claude persona with:
  # - system: The system prompt that shapes Claude's behavior
  # - description: Human-readable explanation of the profile's purpose
  CLAUDE_PROFILES = {
      "code_review": {
          "system": (
              "You are a senior software engineer specializing in code "
              "security, performance, and maintainability. Identify "
              "vulnerabilities, inefficiencies, and best practice violations "
              "clearly and concisely. Focus on actionable feedback."
          ),
          "description": "Performs detailed code and security reviews with actionable feedback."
      },
      "summarize": {
          "system": (
              "You are a precise summarizer. Extract key insights, remove "
              "redundancy, and produce clear, short summaries. Focus on "
              "the most important information and maintain accuracy."
          ),
          "description": "Summarizes text accurately and briefly, preserving key insights."
      },
      "explain": {
          "system": (
              "You are an educator specializing in making complex topics simple. "
              "Explain concepts for beginners using analogies, progressive "
              "explanations, and clear examples. Avoid jargon unless necessary."
          ),
          "description": "Explains complex topics in simple, beginner-friendly terms."
      },
      "creative": {
          "system": (
              "You are a creative writer. Generate imaginative, engaging, "
              "and original ideas with vivid language. Think outside the box "
              "and surprise the user with creative perspectives."
          ),
          "description": "Creative writing and ideation with imaginative perspectives."
      },
      "general": {
          "system": (
              "You are a helpful, knowledgeable AI assistant. Provide clear, "
              "accurate, and useful responses. Be concise but thorough."
          ),
          "description": "General-purpose reasoning and assistance."
      },
  }

• server.py:31-34 (registration)

  Import statement in the main server.py that triggers the self-registration of the ask_specialized_claude tool via its @mcp.tool decorator.

  # ✅ ACTIVE: Specialized Claude (Meta-AI)
  
  import tools.anthropic_tools