ydc-claude-agent-sdk-integration_skill

This skill guides you through integrating the Claude Agent SDK with You.com MCP in Python or TypeScript for seamless tooling.

TypeScript

4

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill youdotcom-oss/agent-skills --skill ydc-claude-agent-sdk-integration

SKILL.md14.2 KB

Overview

This skill integrates the Claude Agent SDK with You.com’s HTTP MCP server for Python and TypeScript. It provides guided prompts, ready-to-run templates, and configuration snippets so developers can enable You.com tools inside Claude agent workflows quickly. Use it when you need Claude agents to call You.com search and content extraction tools via MCP.

How this skill works

The skill walks you through language selection (Python or TypeScript), SDK version choice for TypeScript (v1 stable or v2 preview), package installation, and environment variable setup. It produces complete file templates or patches an existing file by adding an HTTP MCP server block that points to https://api.you.com/mcp and enables the You.com MCP tools. After configuration, the agent can call mcp__ydc__you_search and mcp__ydc__you_contents.

When to use it

You want Claude agents to access web search and page content via You.com MCP tools
Setting up a new integration file quickly with working templates in Python or TypeScript
Adding You.com MCP server configuration into an existing Claude Agent SDK project
Testing agentic workflows that require external tool calls from Claude
Installing an interactive skill into Claude Code for step-by-step setup

Best practices

Prefer TypeScript v1 for production; reserve v2 only for preview use cases that need send/receive patterns
Store YDC_API_KEY and ANTHROPIC_API_KEY in environment variables or a secure secrets store
Ensure allowedTools lists include the full mcp__ydc__ prefix (mcp__ydc__you_search, mcp__ydc__you_contents)
Validate Authorization header uses Bearer ${YDC_API_KEY} and has no extra whitespace
Test with the provided example query before integrating into larger workflows

Example use cases

Search for the latest AI news and summarize results using Claude with You.com search
Extract and analyze web page content automatically via mcp__ydc__you_contents within an agent
Add You.com tools to an existing agent-based assistant to provide live web data
Use the Claude Code skill install to get interactive, project-wide setup without manual file edits

FAQ

Use v1 for stable, generator-based workflows in production. Choose v2 only if you need the send/receive pattern and accept preview API instability and TypeScript 5.2+ requirements.

What environment variables are required?

Set YDC_API_KEY for You.com and ANTHROPIC_API_KEY for Anthropic. Both are required for the templates to run.

Why are tools not being called by my agent?

Confirm allowedTools includes the exact names with the mcp__ydc__ prefix (mcp__ydc__you_search and mcp__ydc__you_contents) and that the MCP server block is configured with the correct Authorization header.