> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# You.com

> **This Connector is in Beta**
>
> Merge has validated You.com against the provider's documented API and not yet verified it against the live one, so its behavior can differ from the documentation. It carries the same tool surface it will have at general availability. [Connectors overview](/merge-agent-handler/connectors/overview) covers the tier and how to turn Beta Connectors off.

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Search for news on EU AI Act enforcement from the past month and cite your sources.
* Run a research task comparing the three largest vector database vendors and summarize the result.
* Answer how current interest rates compare to the 10-year average, with citations.

## Available Tools

#### search_web

Search live web and news results and return links with snippets; use get_answer for a single cited answer. Supports d...

#### get_contents

Extract clean HTML or Markdown from one or more public web URLs. Set formats to control the returned content.

#### get_answer

Answer a factual web question quickly with citations (one hop); use run_research for multi-step synthesis or search_w\...

#### run_research

Research a complex, multi-step question with cited sources; use get_answer for quick facts and run_finance_research f...

#### get_research_task

Get the status and final result of a background research task. Use the task_id returned by run_research.

#### list_research_events

Read progress events for a background research task. Use the task_id returned by run_research and from_id to resume. ...

#### run_finance_research

Research a financial or company-filings question using You.com's finance index and return a cited answer; use run_res...

#### search_images

Search image results with titles, source page URLs, image URLs, and thumbnails. This You.com endpoint is in beta.

#### get_account_balance

Get remaining You.com API credits. The balance is returned in cents.