> 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`.

# Grok Build

The You.com plugin for [Grok Build](https://x.ai/cli), the Grok terminal coding agent, 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 Grok 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 Marketplace and Install

```bash
grok plugin marketplace add youdotcom-oss/agent-skills
grok plugin install you --trust
```

Grok only loads a plugin's skills and MCP servers once you trust it. Without `--trust`, the install command shows what the plugin contains and stops. To load the plugin into an open session, press `r` in the Plugins tab, or start a new session.

## Sign In

The `you`, `you-research`, and `you-finance` servers sign in with your You.com account over OAuth. Open `/mcps`, select one of them, and press `i` to authenticate.

## Try It

```text
Use you-web to find what's new in the latest TypeScript release, with sources.
```

## What the Plugin Installs

**MCP servers.** Open `/mcps` to see them:

| Server         | Endpoint                                   | Auth  |
| -------------- | ------------------------------------------ | ----- |
| `you`          | `https://api.you.com/mcp`                  | OAuth |
| `you-research` | `https://api.you.com/mcp/research`         | OAuth |
| `you-finance`  | `https://api.you.com/mcp/finance`          | OAuth |
| `you-discover` | `https://api.you.com/mcp?profile=discover` | None  |

**Skills.** Plugin skills appear in the slash menu. When a name is ambiguous, Grok shows it prefixed with the plugin name, such as `/you:you-web`.

| 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, add the You.com MCP server with `grok mcp add`.

**Free profile** (`you-search` and `you-discover`, 100 queries per day, no account):

```bash
grok mcp add --transport http you-com "https://api.you.com/mcp?profile=free"
```

**API key.** Get a key at [you.com/platform](https://you.com/platform):

```bash
grok mcp add --transport http you-com https://api.you.com/mcp \
  --header "Authorization: Bearer <YDC_API_KEY>"
```

## Troubleshooting

#### MCP servers show as blocked

The plugin isn't trusted. Reinstall it with `grok plugin install you --trust`.

#### Skills don't appear after install

Press `r` in the Plugins tab to reload plugins, or start a new session.

#### Plugin not found in marketplace

Refresh the marketplace with `grok plugin marketplace update`, then retry `grok plugin install you --trust`.

## Resources

#### [Agent Skills](/docs/agents/skills)

What each You.com skill does and how to install skills in other agents.

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

Endpoints, authentication, and the full tool reference.