# Tavily Cursor MCP Server

A custom Tavily MCP server with **underscore-named tools** for Cursor compatibility.

## Why This Exists

The official Tavily MCP server uses hyphenated tool names (`tavily-search`, `tavily-extract`) which Cursor's CallMcpTool interface doesn't properly recognize. This custom server uses underscore naming (`tavily_search`, `tavily_extract`) to work seamlessly with Cursor.

## Features

- ✅ **tavily_search** - Web search with Tavily API
- ✅ **tavily_extract** - Extract clean content from URLs
- ✅ **tavily_search_qna** - Direct question answering
- ✅ **tavily_search_context** - Generate context for RAG applications

## Installation

### Option 1: Local Installation (Recommended)

1. **Clone or download this directory to your local machine**

2. **Install dependencies:**
   ```bash
   cd tavily-cursor-mcp
   npm install
   ```

3. **Make the script executable (Mac/Linux):**
   ```bash
   chmod +x index.js
   ```

4. **Add to your Cursor `mcp.json`:**
   ```json
   {
     "mcpServers": {
       "tavily_cursor": {
         "command": "node",
         "args": ["/absolute/path/to/tavily-cursor-mcp/index.js"],
         "env": {
           "TAVILY_API_KEY": "your-tavily-api-key-here"
         }
       }
     }
   }
   ```

   **Important:** Replace `/absolute/path/to/tavily-cursor-mcp/` with the actual full path to this directory.

### Option 2: NPM Global Installation

1. **Install globally:**
   ```bash
   cd tavily-cursor-mcp
   npm install -g .
   ```

2. **Add to your Cursor `mcp.json`:**
   ```json
   {
     "mcpServers": {
       "tavily_cursor": {
         "command": "tavily-cursor-mcp",
         "env": {
           "TAVILY_API_KEY": "your-tavily-api-key-here"
         }
       }
     }
   }
   ```

## Configuration

### Cursor MCP Configuration Location

- **Windows:** `%APPDATA%\Cursor\User\globalStorage\mcp.json`
- **Mac:** `~/.cursor/mcp.json` or workspace `.cursor/mcp.json`
- **Linux:** `~/.cursor/mcp.json` or workspace `.cursor/mcp.json`

### Get Your Tavily API Key

1. Go to https://tavily.com
2. Sign up or log in
3. Get your API key from the dashboard
4. Replace `your-tavily-api-key-here` in the config with your actual key

## Usage in Cursor

After installation and configuration, restart Cursor completely. Then use in Agent mode:

```
Use tavily_search to find the latest AI developments
```

```
Use tavily_extract to get the content from https://example.com
```

```
Use tavily_search_qna to answer: What is the capital of France?
```

## Available Tools

### tavily_search

Search the web using Tavily API.

**Parameters:**
- `query` (required): Search query
- `search_depth`: "basic" or "advanced" (default: "basic")
- `topic`: "general" or "news" (default: "general")
- `days`: Number of days back for news search (default: 3)
- `max_results`: Max results to return (default: 5, max: 20)
- `include_images`: Include images (default: false)
- `include_answer`: Include AI-generated answer (default: false)
- `include_raw_content`: Include raw HTML (default: false)

### tavily_extract

Extract clean content from URLs.

**Parameters:**
- `urls` (required): Array of URLs to extract from

### tavily_search_qna

Get direct answers to questions.

**Parameters:**
- `query` (required): The question to answer
- `search_depth`: "basic" or "advanced" (default: "basic")

### tavily_search_context

Generate context for RAG applications.

**Parameters:**
- `query` (required): Search query
- `search_depth`: "basic" or "advanced" (default: "basic")
- `max_results`: Max results (default: 5)

## Troubleshooting

### Tools not showing up in Cursor

1. Make sure you've **completely quit and restarted Cursor** (not just closed the window)
2. Verify the path in `mcp.json` is correct and absolute
3. Check that Node.js is installed: `node --version` (should be >= 18.0.0)
4. Verify your Tavily API key is correct

### "TAVILY_API_KEY environment variable is required" error

Make sure your API key is set in the `env` section of your `mcp.json` configuration.

### Tools discovered but not usable

This was the original problem! This server fixes it by using underscores instead of hyphens in tool names.

## Testing

You can test the server directly:

```bash
TAVILY_API_KEY=your-key-here node index.js
```

Then use the MCP Inspector or send MCP protocol messages via stdin.

## License

MIT