> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavily.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Add Tavily web search, extraction, crawling, and research to Cursor in one click.

Give [Cursor](https://cursor.com) live web search, extraction, crawling, and research through Tavily's hosted [MCP server](https://docs.tavily.com/documentation/mcp.md).

**1. Add Tavily**

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=tavily\&config=eyJ1cmwiOiJodHRwczovL21jcC50YXZpbHkuY29tL21jcC8ifQ==)

Or add it to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json theme={null}
{
  "mcpServers": {
    "tavily": {
      "url": "https://mcp.tavily.com/mcp/"
    }
  }
}
```

**2. Sign in**

Open **Customize**, click **Authenticate** next to `tavily`, and sign in to Tavily in your browser.

**3. Try it**

In Agent chat, ask:

> Use Tavily to find the official docs for a dependency in this project, check our usage against the installed version, and cite the source.

## More options

> [accordion] Install the full plugin (MCP + skills + commands)
>
> The [Tavily plugin](https://cursor.com/marketplace/tavily) bundles the MCP server with Tavily skills and commands.
>
> [Open in Cursor Marketplace](https://cursor.com/marketplace/tavily)
>
> Install it from the marketplace, or type `/add-plugin tavily` in chat. Choose **Add for Myself** or **Add to Project**, then click **Authenticate** under **MCPs** on the plugin page. Run `/tavily-setup` if you also want the CLI fallback. See the [plugin repository](https://github.com/tavily-ai/tavily-cursor-plugin).

> [accordion] Use an API key or keyless access
>
> To skip OAuth, add your key as a header. Cursor supports [environment-variable interpolation](https://cursor.com/docs/mcp#config-interpolation), so the key can stay out of the file:
>
> ```json theme={null}
> "tavily": {
>   "url": "https://mcp.tavily.com/mcp/",
>   "headers": { "Authorization": "Bearer ${env:TAVILY_API_KEY}" }
> }
> ```
>
> For limited Search and Extract without signing in, use `"headers": { "X-Tavily-Access-Mode": "keyless" }` instead. See [keyless access](https://docs.tavily.com/documentation/keyless.md).

> [accordion] Run the MCP server locally
>
> Requires [Node.js](https://nodejs.org/en/download) 20+ and a [Tavily API key](https://app.tavily.com). Add to `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "tavily-local": {
>       "command": "npx",
>       "args": ["-y", "tavily-mcp@latest"],
>       "env": { "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY" }
>     }
>   }
> }
> ```
>
> Enable `tavily-local` in **Customize** and confirm its tools load.

> [accordion] Use the CLI and Agent Skills instead of MCP
>
> Install the [Tavily CLI](https://docs.tavily.com/documentation/tavily-cli.md), sign in, and install the [Agent Skills](https://docs.tavily.com/documentation/agent-skills.md) in one step:
>
> ```bash theme={null}
> npx @tavily/cli init --agent cursor
> ```
>
> To install the skills for one project only, run `npx skills add tavily-ai/skills --skill '*' --agent cursor` inside that project instead.
>
> Restart the agent session to load the skills. Add `--global` to install them for all projects.

## Resources

* [Tavily plugin on Cursor Marketplace](https://cursor.com/marketplace/tavily) · [plugin repository](https://github.com/tavily-ai/tavily-cursor-plugin)
* [Cursor MCP docs](https://cursor.com/docs/mcp) · [Cursor plugin docs](https://cursor.com/docs/plugins)
* [Tavily MCP server](https://docs.tavily.com/documentation/mcp.md) · [Agent Skills](https://docs.tavily.com/documentation/agent-skills.md) · [CLI](https://docs.tavily.com/documentation/tavily-cli.md)
