| name | ydc-claude-agent-sdk-integration |
| description | Integrate Claude Agent SDK with You.com HTTP MCP server for Python and TypeScript. Use when developer mentions Claude Agent SDK, Anthropic Agent SDK, or integrating Claude with MCP tools. |
| license | MIT |
| compatibility | Python 3.10+ or TypeScript 5.2+ (for v2), Node.js 18+ |
| metadata | {"author":"youdotcom-oss","category":"sdk-integration","version":"1.0.0","keywords":"claude,anthropic,claude-agent-sdk,agent-sdk,mcp,you.com,integration,http-mcp,web-search,python,typescript"} |
Integrate Claude Agent SDK with You.com MCP
Interactive workflow to set up Claude Agent SDK with You.com's HTTP MCP server.
Workflow
-
Ask: Language Choice
-
If TypeScript - Ask: SDK Version
- v1 (stable, generator-based) or v2 (preview, send/receive pattern)?
- Note: v2 requires TypeScript 5.2+ for
await using support
-
Install Package
- Python:
pip install claude-agent-sdk
- TypeScript:
npm install @anthropic-ai/claude-agent-sdk
-
Ask: Environment Variables
- Using standard
YDC_API_KEY and ANTHROPIC_API_KEY?
- Or custom names?
- Have they set them?
- If NO: Guide to get keys:
-
Ask: File Location
- NEW file: Ask where to create and what to name
- EXISTING file: Ask which file to integrate into (add HTTP MCP config)
-
Create/Update File
For NEW files:
- Use the complete template code from the "Complete Templates" section below
- User can run immediately with their API keys set
For EXISTING files:
-
Add HTTP MCP server configuration to their existing code
-
Python configuration block:
from claude_agent_sdk import query, ClaudeAgentOptions
options = ClaudeAgentOptions(
mcp_servers={
"ydc": {
"type": "http",
"url": "https://api.you.com/mcp",
"headers": {
"Authorization": f"Bearer {os.getenv('YDC_API_KEY')}"
}
}
},
allowed_tools=[
"mcp__ydc__you_search",
"mcp__ydc__you_express",
"mcp__ydc__you_contents"
]
)
-
TypeScript configuration block:
const options = {
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: `Bearer ${process.env.YDC_API_KEY}`
}
}
},
allowedTools: [
'mcp__ydc__you_search',
'mcp__ydc__you_express',
'mcp__ydc__you_contents'
]
};
Complete Templates
Use these complete templates for new files. Each template is ready to run with your API keys set.
Python Template (Complete Example)
"""
Claude Agent SDK with You.com HTTP MCP Server
Python implementation with async/await pattern
"""
import os
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
ydc_api_key = os.getenv("YDC_API_KEY")
anthropic_api_key = os.getenv("ANTHROPIC_API_KEY")
if not ydc_api_key:
raise ValueError(
"YDC_API_KEY environment variable is required. "
"Get your key at: https://you.com/platform/api-keys"
)
if not anthropic_api_key:
raise ValueError(
"ANTHROPIC_API_KEY environment variable is required. "
"Get your key at: https://console.anthropic.com/settings/keys"
)
async def main():
"""
Example: Search for AI news and get results from You.com MCP server
"""
options = ClaudeAgentOptions(
mcp_servers={
"ydc": {
"type": "http",
"url": "https://api.you.com/mcp",
"headers": {"Authorization": f"Bearer {ydc_api_key}"},
}
},
allowed_tools=[
"mcp__ydc__you_search",
"mcp__ydc__you_express",
"mcp__ydc__you_contents",
],
model="claude-sonnet-4-5-20250929",
)
async for message query(
prompt=,
options=options,
):
message. == :
(message.content)
message. == :
()
()
message. == :
()
__name__ == :
asyncio.run(main())
TypeScript v1 Template (Complete Example)
import { query } from '@anthropic-ai/claude-agent-sdk';
const ydcApiKey = process.env.YDC_API_KEY;
const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
if (!ydcApiKey) {
throw new Error(
'YDC_API_KEY environment variable is required. ' +
'Get your key at: https://you.com/platform/api-keys'
);
}
if (!anthropicApiKey) {
throw new Error(
'ANTHROPIC_API_KEY environment variable is required. ' +
'Get your key at: https://console.anthropic.com/settings/keys'
);
}
async function main() {
const result = query({
prompt: 'Search for the latest AI news from this week',
options: {
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: ,
},
},
},
: [
,
,
,
],
: ,
},
});
( msg result) {
(msg. === ) {
.(msg.);
} (msg. === ) {
.();
.();
} (msg. === ) {
.();
}
}
}
().(.);
TypeScript v2 Template (Complete Example)
import { unstable_v2_createSession } from '@anthropic-ai/claude-agent-sdk';
const ydcApiKey = process.env.YDC_API_KEY;
const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
if (!ydcApiKey) {
throw new Error(
'YDC_API_KEY environment variable is required. ' +
'Get your key at: https://you.com/platform/api-keys'
);
}
if (!anthropicApiKey) {
throw new Error(
'ANTHROPIC_API_KEY environment variable is required. ' +
'Get your key at: https://console.anthropic.com/settings/keys'
);
}
async function main() {
await using session = unstable_v2_createSession({
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: ,
},
},
},
: [
,
,
,
],
: ,
});
session.();
( msg session.()) {
(msg. === ) {
.(msg.);
} (msg. === ) {
.();
.();
} (msg. === ) {
.();
}
}
}
().(.);
HTTP MCP Server Configuration
All templates use You.com's HTTP MCP server for simplicity:
Python:
mcp_servers={
"ydc": {
"type": "http",
"url": "https://api.you.com/mcp",
"headers": {
"Authorization": f"Bearer {ydc_api_key}"
}
}
}
TypeScript:
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: `Bearer ${ydcApiKey}`
}
}
}
Benefits of HTTP MCP:
- ✅ No local installation required
- ✅ Stateless request/response model
- ✅ Always up-to-date with latest version
- ✅ Consistent across all environments
- ✅ Production-ready and scalable
- ✅ Works with existing HTTP infrastructure
Available You.com Tools
After configuration, Claude can discover and use:
mcp__ydc__you_search - Web and news searchmcp__ydc__you_express - AI-powered answers with web contextmcp__ydc__you_contents - Web page content extraction
Environment Variables
Both API keys are required:
export YDC_API_KEY="your-you-api-key-here"
export ANTHROPIC_API_KEY="your-anthropic-api-key-here"
Get your API keys:
Validation Checklist
Before completing:
Testing Your Integration
Python:
python your-file.py
TypeScript:
npx tsx your-file.ts
tsc your-file.ts && node your-file.js
Common Issues
Cannot find module @anthropic-ai/claude-agent-sdk
Install the package:
npm install @anthropic-ai/claude-agent-sdk
bun add @anthropic-ai/claude-agent-sdk
yarn add @anthropic-ai/claude-agent-sdk
pnpm add @anthropic-ai/claude-agent-sdk
YDC_API_KEY environment variable is required
Set your You.com API key:
export YDC_API_KEY="your-api-key-here"
Get your key at: https://you.com/platform/api-keys
ANTHROPIC_API_KEY environment variable is required
Set your Anthropic API key:
export ANTHROPIC_API_KEY="your-api-key-here"
Get your key at: https://console.anthropic.com/settings/keys
MCP connection fails with 401 Unauthorized
Verify your YDC_API_KEY is valid:
- Check the key at https://you.com/platform/api-keys
- Ensure no extra spaces or quotes in the environment variable
- Verify the Authorization header format:
Bearer ${YDC_API_KEY}
Tools not available or not being called
Ensure allowedTools includes the correct tool names:
mcp__ydc__you_search (not you_search)mcp__ydc__you_express (not you_express)mcp__ydc__you_contents (not you_contents)
Tool names must include the mcp__ydc__ prefix.
TypeScript error: Cannot use 'await using'
The v2 SDK requires TypeScript 5.2+ for await using syntax.
Solution 1: Update TypeScript
npm install -D typescript@latest
Solution 2: Use manual cleanup
const session = unstable_v2_createSession({ });
try {
await session.send('Your query');
for await (const msg of session.receive()) {
}
} finally {
session.close();
}
Solution 3: Use v1 SDK instead
Choose v1 during setup for broader TypeScript compatibility.
Additional Resources
