you-research

---
name: you-research
description: "Multi-source research with citations using You.com. Use for questions that need several sources compared and synthesized, such as library or framework comparisons, tool and vendor evaluations, market research, or deep-dive reports. Routes between a cost-conscious agentic search loop and the one-shot `you-research` MCP tool."
compatibility: Requires network access and You.com MCP tools with `YDC_API_KEY`, OAuth, or MPP/x402 payment support.
license: MIT
metadata:
  mcp_servers: '{"you-research":{"url":"https://api.you.com/mcp/research"}}'
  author: youdotcom-oss
  version: 0.5.1
  category: research
  keywords: you.com,mcp,web-search,content-extraction,deep-research,citations
---

# You.com Research Routing

Use this skill to choose the right You.com research path for the user's goal: agent-led search with `you-search` and `you-contents`, or one-shot cited synthesis with the `you-research` MCP tool.

## Prerequisites

The You.com MCP endpoint must be reachable from the host:

- Managed research (`you-research`): `https://api.you.com/mcp/research` with OAuth (preferred), `YDC_API_KEY` bearer auth, or an MPP/x402-aware MCP client.

MPP/x402-aware MCP clients may receive HTTP `402` payment challenges from You.com tools, then retry with payment headers. Let the host client handle external payment and retry; do not add wallet signing logic to this skill.

## Managed research with the you-research MCP tool

Call the `you-research` MCP tool when the user wants a synthesized answer with citations in one step. It runs You.com's managed research pipeline and returns a concise answer with inline citations and source metadata, so the host does not orchestrate multi-step search itself.

For keyless payment with no API key and no manual signing, compose the You.com MCP server with the Coinbase Payments MCP server; see [Coinbase Payments MCP path](references/coinbase-payments-mcp.md) for setup and when to choose it.

If the `you-research` tool is unavailable or the client cannot tolerate its response time, fall back to the agent-led search pipeline in the `you-web` skill and say which path was used.

## Decision Tree

- User is cost-conscious or wants to develop/fine-tune a research skill -> use the agent-led search pipeline in the `you-web` skill.
- User needs a one-shot synthesized answer with citations -> call the `you-research` MCP tool.
- User needs OAuth or MPP/x402 payment handling -> use the `you-research` MCP tool with a payment-aware MCP client or the Coinbase Payments MCP composition.
- Required MCP tools are unavailable -> tell the user what is missing, provide the setup options from the prerequisites above, and request approval before installing, connecting, or changing configuration.
- Simple lookup -> use `you-search` once, answer directly.
- URL provided -> use `you-contents` on those URLs.
- Everything else -> use the agent-led search pipeline in the `you-web` skill.

Preserve the core research requirements regardless of path: read sources before relying on exact claims, cross-check key facts, cite real URLs, and finish with the best supported answer even when evidence is incomplete.

From youdotcom-oss/agent-skills at 9bc61f5, shown as plain text under its license: MIT (permissive). The license text is in skills/you-research/SKILL.md.

• SKILL.md3.2 KB · 8b75f107543d
• references/
• coinbase-payments-mcp.md1.6 KB · a5fd59704132

2 files, 4.8 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.