You Research

by youdotcom-ossa692b6f34facMITListed Oct 8, 2026Updated Oct 8, 2026

Route research tasks between a cost-conscious agentic search workflow and the You.com you-research MCP tool for one-shot cited synthesis.

AI-generated overview

Routes research tasks between an agent-led search workflow and the You.com you-research MCP tool for cited synthesis.

What it does
This skill provides routing guidance for choosing between two You.com research paths: an agent-led search pipeline using you-search and you-contents, or a one-shot managed research call to the you-research MCP tool that returns a synthesized answer with inline citations and source metadata. It includes a decision tree covering cost-conscious research, one-shot cited answers, payment handling, simple lookups, and URL-based extraction, plus fallback behavior when tools are unavailable. It also points to a reference document for composing the You.com MCP server with the Coinbase Payments MCP server for keyless payment.
When to use it
Use it when a user needs web research and you must decide whether to orchestrate multi-step searching or call a managed research tool for a single cited answer. It also applies when handling OAuth or MPP/x402 payment flows, when required MCP tools are missing, or when a simple lookup or URL extraction is enough.
Requirements
Network access to the You.com MCP endpoint, You.com MCP tools (you-research, you-search, you-contents), and authentication via YDC_API_KEY, OAuth, or an MPP/x402-aware MCP client; the Coinbase Payments MCP composition is optional for keyless payment. No scripts are shipped.

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 YDC_API_KEY bearer auth, OAuth, 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 [blocked] 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.

Source and attribution

Source:youdotcom-oss/agent-skillsinskills/you-researchat commita692b6f

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal