Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

You.com MCP connector

Bearer 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-contents',
      toolInput: { urls: [] },
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

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