> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://you.com/docs/llms.txt.
> For full documentation content, see https://you.com/docs/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://you.com/docs/_mcp/server.

# Cursor

Give Cursor real-time web search, content extraction, and citation-backed research through the [You.com MCP Server](/docs/build-with-agents/mcp-server).

## One-click install

[![Add MCP Server to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=you-com\&config=eyJ1cmwiOiJodHRwczovL2FwaS55b3UuY29tL21jcCJ9)

Clicking the button opens Cursor and pre-fills the configuration. Cursor will trigger OAuth automatically — sign in to You.com in the browser window that opens, and the integration is live.

## Manual setup

If you'd rather configure by hand, open **Cursor settings → MCP → Add new server**, and paste:

```json
{
  "mcpServers": {
    "you-com": {
      "url": "https://api.you.com/mcp"
    }
  }
}
```

**Cursor gotcha:** don't include a `"type": "http"` field. Cursor's MCP config format omits it.

**With an API key (skip OAuth):**

```json
{
  "mcpServers": {
    "you-com": {
      "url": "https://api.you.com/mcp",
      "headers": {
        "Authorization": "Bearer YDC-YOUR-API-KEY"
      }
    }
  }
}
```

**Free tier (search only, no auth):**

```json
{
  "mcpServers": {
    "you-com": {
      "url": "https://api.you.com/mcp?profile=free"
    }
  }
}
```

## Turn off Cursor's built-in web search

Go to **Settings → Agents** and turn off the built-in web search tool. This avoids the agent picking Cursor's lower-quality search when You.com is available, and prevents duplicate tool calls on the same query.

## Quick demo

Open the agent panel and try:

```text
Find the official Next.js 15 migration guide and pull the breaking-changes section verbatim.
```

```text
Research which AI search APIs offer OAuth 2.1, with citations.
```

## Troubleshooting

* **Server not appearing** — restart Cursor after editing the MCP config. The reload-on-save behavior is unreliable in current builds.
* **OAuth window doesn't open** — check that you don't have a popup blocker active for `cursor://` deeplinks.
* **Tools show but never get called** — confirm Cursor's built-in web search is disabled (see above). The agent may be preferring the cheaper local tool.
* **`"type": "http"` error** — remove the `type` field. Cursor doesn't use it.