Skip to content
Scalekit Docs
Talk to an EngineerDashboard

You.com MCP

Vendor MCP6 toolsBearer TokenSearchAI

Connect to You.com MCP. Search the web, research topics with cited sources, and extract full page content using You.com's AI-powered search and research...

You.com MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Set up the connector

    Section titled “Set up the connector”

    Register your You.com MCP credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

    Dashboard setup steps

    Register your You.com API key with Scalekit so it can authenticate and proxy search requests on behalf of your users. You.com MCP uses API key authentication — there is no redirect URI or OAuth flow.

    1. Get a You.com API key

      • Go to you.platform and sign in or create an account.
      • In the left sidebar, under API Management, click API Keys.
      • Enter a name for your key (e.g. Agent Auth) and click Create.

      You.com API Keys page showing the Create new key form and existing keys list

      • Copy the generated key — it starts with ydc-sk-.

    2. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
      • Search for You.com MCP and click Create.
      • Note the Connection name — use this as connection_name in your code (e.g., youmcp).

    3. Add a connected account

      Connected accounts link a specific user identifier in your system to a You.com API key. Add them via the dashboard for testing, or via the Scalekit API in production.

      Via dashboard (for testing)

      • Open the connection and click the Connected Accounts tab → Add account.
      • Fill in Your User’s ID and API Key, then click Save.

      Via API (for production)

      await scalekit.connect.upsertConnectedAccount({
        connectionName: 'youmcp',
        identifier: 'user@example.com',
        credentials: { apiKey: 'ydc-sk-...' },
      })

  4. Make your first call

    Section titled “Make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'youmcp'
    const identifier = 'user_123'
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'youmcp_you-balance',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • You-discover records — Discover AI agents, MCP servers, A2A agents, and skills via ARD Agent Finder services
  • You-balance records — Get the remaining credit balance for the billing entity associated with your You.com API key
  • You-answer records — Fast live-web answer generation returning one synthesized answer with verified inline citations, citation excerpts, and supporting web results
  • You-search records — Search the web and news using You.com
  • You-research records — Research a topic in depth using You.com’s AI
  • You-contents records — Extract content from one or more web pages in markdown, HTML, or structured metadata format

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

youmcp_you-answer#Fast live-web answer generation returning one synthesized answer with verified inline citations, citation excerpts, and supporting web results. Use when the caller wants a single sourced answer; use research for deeper multi-step investigation, effort control, structured output, or background tasks. Supports freshness, country, language, and domain filters.7 params

Fast live-web answer generation returning one synthesized answer with verified inline citations, citation excerpts, and supporting web results. Use when the caller wants a single sourced answer; use research for deeper multi-step investigation, effort control, structured output, or background tasks. Supports freshness, country, language, and domain filters.

NameTypeRequiredDescription
querystringrequiredFocused live-web question or lookup request. Returns a synthesized answer with inline citations, citation excerpts, and supporting web results.
boost_domainsarrayoptionalDomains to prefer in ranking (up to 500). Can combine with exclude_domains, not include_domains.
countrystringoptionalA supported country code that determines the geographical focus.
exclude_domainsarrayoptionalDomains to exclude from results (up to 500).
freshnessstringoptionalday/week/month/year or YYYY-MM-DDtoYYYY-MM-DD.
include_domainsarrayoptionalDomains to exclusively include (up to 500).
languagestringoptionalA supported BCP 47 language tag that determines the language.
youmcp_you-balance#Get the remaining credit balance for the billing entity associated with your You.com API key. Balance is in cents (divide by 100 for USD).0 params

Get the remaining credit balance for the billing entity associated with your You.com API key. Balance is in cents (divide by 100 for USD).

youmcp_you-contents#Extract content from one or more web pages in markdown, HTML, or structured metadata format. Supports up to 100 URLs per call.4 params

Extract content from one or more web pages in markdown, HTML, or structured metadata format. Supports up to 100 URLs per call.

NameTypeRequiredDescription
urlsarrayrequiredOne or more public HTTP/HTTPS URLs to extract content from (up to 100).
crawl_timeoutnumberoptionalTimeout in seconds for live-crawling pages (1–60).
formatstringoptional(Deprecated) Output format - use formats array instead
formatsarrayoptionalOutput formats to return: markdown (plain text), html (layout preserved), or metadata (structured data).
youmcp_you-discover#Discover AI agents, MCP servers, A2A agents, and skills via ARD Agent Finder services. Search-only — never installs or connects. Returns ranked results with relevance scores.4 params

Discover AI agents, MCP servers, A2A agents, and skills via ARD Agent Finder services. Search-only — never installs or connects. Returns ranked results with relevance scores.

NameTypeRequiredDescription
querystringrequiredNatural-language task to find agents/tools for.
finderstringoptionalWhich Agent Finder discovery service(s) to query.
finder_urlstringoptionalOptional custom finder URL (must be public http/https). Augments selected finders.
limitintegeroptionalMax consolidated results (1–25).
youmcp_you-research#Research a topic in depth using You.com's AI. Returns comprehensive answers with cited sources at configurable effort levels (lite, standard, deep, exhaustive).2 params

Research a topic in depth using You.com's AI. Returns comprehensive answers with cited sources at configurable effort levels (lite, standard, deep, exhaustive).

NameTypeRequiredDescription
inputstringrequiredThe research question or complex query for in-depth multi-step investigation (max 40,000 characters).
research_effortstringoptionalHow much effort to spend: lite (fast), standard (balanced), deep (thorough), exhaustive (most comprehensive).