mcpField
Y
you-research

you-research

github.com/youdotcom-ossProductivity97181 installsUpdated today
Repository

About you-research

A You.com research-routing skill for agents. It selects between agent-led web search and the you-research MCP tool based on the request, while retaining source-reading and citation requirements.

Key features

  1. 01Route requests to research paths
  2. 02Use you-research for cited synthesis
  3. 03Fallback to agent-led search
  4. 04Handle URL lookup and simple searches
  5. 05Preserve source verification and citations

Use cases

  1. 01Produce a cited, synthesized research answer
  2. 02Research a topic through agent-led search
  3. 03Summarize content from provided URLs

MCP support

Uses the You.com MCP endpoint and its you-research tool for one-step synthesized answers with citations. It also describes OAuth, API-key, and payment-aware client options.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/youdotcom-oss/agent-skills --skill you-research

After installing, type/you-researchin Claude Code to confirm it loaded.

Bundled filesreferences/coinbase-payments-mcp.md

Details

From the project README

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

Comments

Markdown supported