You.com MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. 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. Make your first call

   Node.js

   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)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "youmcp"
   identifier = "user_123"
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"urls":[]},
       tool_name="youmcp_you-contents",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

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

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.

Name Type Required Description

urls array required One or more public HTTP/HTTPS URLs to extract content from (up to 100).

crawl_timeout number optional Timeout in seconds for live-crawling pages (1–60).

format string optional (Deprecated) Output format - use formats array instead

formats array optional Output 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).

Name Type Required Description

input string required The research question or complex query for in-depth multi-step investigation (max 40,000 characters).

research_effort string optional How much effort to spend: lite (fast), standard (balanced), deep (thorough), exhaustive (most comprehensive).

youmcp_you-search # Search the web and news using You.com. Supports domain filtering, language and country targeting, freshness filters, and live-crawl for full page content. 12 params ▾

Search the web and news using You.com. Supports domain filtering, language and country targeting, freshness filters, and live-crawl for full page content.

Name Type Required Description

query string required Search query string. Supports operators: site:domain.com, filetype:pdf, +term, -term, AND/OR/NOT, lang:en.

count integer optional Maximum number of results to return per section (1–100).

country string optional Country code to localize search results (ISO 3166-1 alpha-2).

crawl_timeout integer optional Timeout in seconds for live-crawling pages (1–60).

exclude_domains array optional List of domains to exclude from search results (up to 500).

freshness string optional Limit results by recency: day, week, month, year, or a date range YYYY-MM-DDtoYYYY-MM-DD.

include_domains array optional List of domains to restrict search results to (up to 500).

language string optional Language code (BCP 47) to filter search results.

livecrawl string optional Enable live-crawling of full page content for the specified section: web, news, or all.

livecrawl_formats array optional Output formats for live-crawled content: html and/or markdown.

offset integer optional Pagination offset for results (0–9).

safesearch string optional Safe-search filter level applied to results.