> For clean Markdown of any page, append `.md` to the page URL.
> Documentation index: https://you.com/docs/llms.txt (section indexes: append `/llms.txt` to any section URL).
> Search these docs: Docs MCP at https://you.com/docs/_mcp/server (`searchDocs`, no API key).
> Call live You.com APIs: Product MCP at https://api.you.com/mcp (keyless `?profile=free` exposes `you-search` and `you-discover`. Research and finance use `/mcp/research`, `/mcp/finance`, or `?tools=` on `/mcp`). To pick an API or integration path, call `you-discover` on that server instead of guessing.
> OpenAPI: https://you.com/docs/openapi.json—auth header `X-API-Key`, env `YDC_API_KEY`.

# Cursor

The official [You.com plugin for Cursor](https://cursor.com/marketplace/ydc) installs four skills and the You.com MCP servers from the [agent-skills repo](https://github.com/youdotcom-oss/agent-skills). The MCP servers give the agent tools such as `you-search`, `you-contents`, `you-research`, and `you-finance`. The skills tell it when to use each one and how to cite what it finds.

> **Install the Docs MCP server**
>
> The Docs MCP server lets your agent search over the entirety of these docs. Free to use.
>
> Install `https://you.com/docs/_mcp/server`. See the [Docs MCP Server guide](/docs/agents/docs-mcp-server) to learn more.

## Install the Plugin

## Add the Plugin From the Cursor Marketplace

Open the [You.com listing](https://cursor.com/marketplace/ydc) in the Cursor Marketplace and install it, or run this command in an agent session:

```text
/add-plugin you
```

To install from source instead, open **Customize** in the Cursor sidebar, choose **From GitHub Repository**, and enter:

```text
https://github.com/youdotcom-oss/agent-skills
```

Cursor reads the repo's `.cursor-plugin/marketplace.json` and lists the `you` plugin. Install it and pick a scope.

To register the GitHub marketplace from the Cursor CLI:

```bash
agent plugin marketplace add https://github.com/youdotcom-oss/agent-skills
```

The CLI registers the marketplace but has no non-interactive install command yet, so install `you` from `/plugin` inside an `agent` session.

## Sign In

The first time the agent calls a You.com tool, Cursor opens a browser window to sign in with your You.com account over OAuth.

## Try It

```text
Use you-web to find the Next.js 15 breaking changes, with sources.
```

> **Info**
>
> Turn off Cursor's built-in web search in **Settings → Agents** so the agent calls You.com instead of running both searches on the same query.

### Included Skills

| Skill          | Use it for                                                                                                            |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| `you-web`      | Current web search and URL reading, with sources cited. Switches to keyless `you-search` when no credentials are set. |
| `you-research` | Choosing between agent-led searching and a single cited `you-research` call                                           |
| `you-finance`  | Finance questions through the `you-finance` tool                                                                      |
| `you-discover` | Finding the right You.com API, MCP server, or SDK for a project you're building                                       |

## Use the MCP Server Without the Plugin

To add only the tools, without the skills, configure the MCP server directly.

## 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"
    }
  }
}
```

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

## Use an API Key

```json
{
  "mcpServers": {
    "you-com": {
      "url": "https://api.you.com/mcp",
      "headers": {
        "Authorization": "Bearer <YDC_API_KEY>"
      }
    }
  }
}
```

## Use the Free Tier

```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. The agent may be preferring the cheaper local tool.

#### type field error

Remove the `type` field. Cursor doesn't use it.

## Resources

#### [MCP Server Reference](/docs/agents/mcp-server)

Endpoint, authentication, and full tool reference.

#### [Python SDK](/docs/integrations/python-sdk)

Call the Web Search, Answer, Contents, Research, and Finance Research APIs from Python.

#### [Integrations](/docs/integrations)

LangChain, crewAI, n8n, Zapier, and other third-party frameworks.