> This page is for Workforce.

> 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

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