Connect AI agents to the You.com MCP server

Setup

1. Install the SDK

   • Node.js
   • Python

   npm install @scalekit-sdk/node dotenv

2. Set your credentials

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

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

3. Create the You.com MCP connection

   In AgentKit > Connections, create a You.com MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

   Console steps with screenshots

   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.

   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.

      

      • 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 one in the dashboard to test. In production, each user adds their own through the authorization link: they enter their credentials on the page it opens.

      In the dashboard, to test

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

      From your backend, if your app already has the credentials

      For example, when users enter them on a settings page in your app:

      • Node.js
      • Python

      1
      import { ConnectorStatus } from '@scalekit-sdk/node'
      2
      
      3
      const authorizationDetails = {
      4
        details: {
      5
          case: 'staticAuth',
      6
          value: { details: { token: 'ydc-sk-...' } },
      7
        },
      8
      }
      9
      
      10
      let { connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      11
        connectionName: 'youmcp',
      12
        identifier: 'user_123',
      13
        authorizationDetails,
      14
      })
      15
      
      16
      // Make sure the account is ACTIVE before the first tool call.
      17
      if (connectedAccount?.status !== ConnectorStatus.ACTIVE) {
      18
        ;({ connectedAccount } = await scalekit.actions.upsertConnectedAccount({
      19
          connectionName: 'youmcp',
      20
          identifier: 'user_123',
      21
          authorizationDetails,
      22
        }))
      23
      }

4. Authorize a user and make your first call

   • Node.js
   • Python

   1
   import { ScalekitClient } from '@scalekit-sdk/node'
   2
   import 'dotenv/config'
   3
   import { createInterface } from 'node:readline/promises'
   4
   
   5
   const scalekit = new ScalekitClient(
   6
     process.env.SCALEKIT_ENVIRONMENT_URL,
   7
     process.env.SCALEKIT_CLIENT_ID,
   8
     process.env.SCALEKIT_CLIENT_SECRET,
   9
   )
   10
   const actions = scalekit.actions
   11
   
   12
   const connector = 'youmcp'
   13
   const identifier = 'user_123'
   14
   
   15
   // Generate an authorization link for the user
   16
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   17
   console.log('Authorize You.com MCP:', link)
   18
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   19
   await rl.question('Press Enter after authorizing...')
   20
   rl.close()
   21
   
   22
   // Make your first call
   23
   const result = await actions.executeTool({
   24
     connector,
   25
     identifier,
   26
     toolName: 'youmcp_you-balance',
   27
     toolInput: {},
   28
   })
   29
   console.log(result)

   npx tsx quickstart.mts

   Each user opens the link once and enters their You.com MCP server credentials there. If your app already has a user's credentials, add the account from your backend instead, as the console steps above show. See Authorize a user for the full flow and statuses.