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

# Pi

[Pi](https://pi.dev/) is a minimal terminal coding harness from Earendil Inc. The [`@youdotcom-oss/pi`](https://www.npmjs.com/package/@youdotcom-oss/pi) package registers four You.com skills and connects six You.com MCP servers through Pi's built-in MCP support for web search, page content, research, finance, and docs lookup. They're the same skills the Claude Code, Cursor, and Codex plugins install.

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

## Quick Setup

## Install the You.com Package

```bash
pi install npm:@youdotcom-oss/pi
```

The package requires Pi 0.99.1 or later. It includes the `you-web`, `you-research`, `you-finance`, and `you-discover` skills and registers these MCP servers:

| MCP server     | Endpoint                                   | Auth             |
| -------------- | ------------------------------------------ | ---------------- |
| `you`          | `https://api.you.com/mcp`                  | API key or OAuth |
| `you-research` | `https://api.you.com/mcp/research`         | API key or OAuth |
| `you-finance`  | `https://api.you.com/mcp/finance`          | API key or OAuth |
| `you-free`     | `https://api.you.com/mcp?profile=free`     | None             |
| `you-discover` | `https://api.you.com/mcp?profile=discover` | None             |
| `you-docs`     | `https://you.com/docs/_mcp/server`         | None             |

Pi names each tool `mcp__<server>__<tool>`, such as `mcp__you__you-search`. Manage the servers with `/mcp`, or override one by adding an entry with the same name to Pi's [`mcp.json`](https://pi.dev/docs/latest/mcp).

To install only the skills, without the MCP servers, use the Agent Skills installer from your project root:

```bash
npx skills add youdotcom-oss/agent-skills
```

## Set Your API Key

The `you-free`, `you-discover`, and `you-docs` servers work without a key. The other three send `YDC_API_KEY` as a bearer token when it's set at launch:

```bash
export YDC_API_KEY="<YDC_API_KEY>"
```

Get a key at [you.com/platform](https://you.com/platform). To sign in over OAuth instead, run `/mcp login you` inside Pi.

## Start Pi

```bash
pi
```

## Try It

Inside a Pi session:

```text
Search the web for the latest TypeScript 5.5 release notes and summarize the breaking changes.
```

Pi activates the relevant skill automatically when a task involves search or page extraction.

## Keyless Tier

With no API key or sign-in, the `you-free` server runs `you-search` (100 queries per day) and the `you-discover` server runs integration discovery. The `you-web` skill switches to the free server on its own. Page extraction, research, and finance need a key or OAuth.

## Quick Demo

```text
Research the trade-offs between Pi's skill model and MCP for capability extension. Cite sources.
```

```text
Extract the install methods from https://pi.dev/docs/latest and turn them into a checklist.
```

## SDK Users: OpenClaw

Building agents with an SDK rather than running them in a terminal harness? The same skills work with [OpenClaw](https://docs.openclaw.ai/tools/skills)—see the [agent-skills repo](https://github.com/youdotcom-oss/agent-skills) for SDK-side integration.

## Troubleshooting

#### pi: command not found

Install Pi from [pi.dev](https://pi.dev/docs/latest) and confirm with `pi --version`.

#### Skill doesn't activate

Confirm the package installed with `pi install npm:@youdotcom-oss/pi`, then restart Pi. If you used `npx skills add`, confirm the skill files are in your project. See [pi.dev/docs/latest](https://pi.dev/docs/latest) for Pi's skill-discovery rules.

#### 401 errors

Confirm `YDC_API_KEY` is exported in the shell that launched Pi, not just in a sub-shell, and starts with `YDC-`. Pi reads the key once at load, so run `/reload` after changing it.

#### Hit the keyless rate limit

Set `YDC_API_KEY` and run `/reload`, or sign in with `/mcp login you`. The keyed servers lift the cap and add `you-contents`, `you-research`, and `you-finance`.

## Resources

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

Skill catalog, install commands, and usage examples.

#### [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.