
mcp
io.github.youdotcom-oss/mcp
Web search, AI agent, and content extraction via You.com APIs
Documentation
You.com DX Toolkit
Open-source toolkit for AI-powered development - npm packages, plugins, and skills that work with Claude Code, Cursor, and 20+ AI coding assistants.
Build with You.com's AI capabilities across your entire workflow:
- š¦ NPM Packages - Ready-to-use integrations for popular frameworks
- š Universal Plugins - Cross-platform plugins for AI coding assistants
- šÆ Claude Code Skills - Context-aware development patterns
NPM Packages
Production-ready packages for building, testing, and shipping agentic workflows:
@youdotcom-oss/mcp
MCP Server giving AI agents real-time web search, AI answers, and content extraction via Model Context Protocol. Documentation ā
@youdotcom-oss/ai-sdk-plugin
Vercel AI SDK plugin for You.com web search and AI agents - zero server setup, works with any model provider. Documentation ā
@youdotcom-oss/teams-anthropic
Use Claude models (Opus, Sonnet, Haiku) in Microsoft Teams.ai apps - drop-in replacement for OpenAI with full streaming support. Documentation ā
Marketplace
Cross-platform plugins for Claude Code, Cursor, Windsurf, and other AI coding assistants. Guided workflows for enterprise integrations, AI workflows, and deployment automation.
ai-sdk-integration
Add You.com's search, AI agent, and content extraction tools to Vercel AI SDK applications - interactive setup workflow with smart integration. Documentation ā
teams-anthropic-integration
Generate Microsoft Teams apps with You.com Anthropic integration using @youdotcom-oss/teams-anthropic - handles setup workflow for new and existing apps. Documentation ā
claude-agent-sdk-integration
Integrate Claude Agent SDK with You.com MCP server - guided setup for Python and TypeScript with HTTP MCP configuration. Documentation ā
openai-agent-sdk-integration
Integrate OpenAI Agents SDK with You.com MCP server - supports Hosted MCP and Streamable HTTP for Python and TypeScript. Documentation ā
Quick Start
Prerequisites:
- Bun >= 1.2.21: Installation guide
- GitHub CLI (recommended):
brew install gh(macOS) or other platforms
Development setup:
# Clone repository
git clone git@github.com:youdotcom-oss/dx-toolkit.git
cd dx-toolkit
# Install dependencies
bun install
# Set up environment variables
cp .env.example .env
# Edit .env and add your YDC_API_KEY and ANTHROPIC_API_KEY
source .env
# Authenticate with GitHub (if using gh CLI)
gh auth login
# Build all packages
bun run build
# Run all tests
bun test
# Run all quality checks
bun run check
For comprehensive development guidelines, see AGENTS.md.
Monorepo Commands
This toolkit uses Bun workspaces. Commands can run at workspace-level (all packages) or package-level (specific package).
Workspace-Level Commands
Run from repository root to affect all packages:
bun install # Install dependencies for all packages
bun run build # Build all packages
bun test # Test all packages
bun run check # Run all quality checks (biome + types + package)
bun run check:write # Auto-fix all issues across all packages
Package-Specific Commands
From Root (run specific package commands):
# MCP Server (using root shortcuts)
bun run dev:mcp # Start MCP server in STDIO mode
bun run start:mcp # Start MCP server in HTTP mode
bun run test:mcp # Test MCP server only
# Or call package scripts directly:
bun --cwd packages/mcp dev
bun --cwd packages/mcp start
bun --cwd packages/mcp test
# All packages follow this pattern:
# bun run <command>:<package>
# bun --cwd packages/<package> <command>
Documentation
Package Documentation
- MCP Server README - User-focused setup and usage guide with API examples
- AI SDK Plugin README - Vercel AI SDK integration guide
- Teams Anthropic README - Microsoft Teams.ai integration guide
Contributor Documentation
- AGENTS.md - Comprehensive development guidelines for maintainers and agentic IDEs
- Package-Level CONTRIBUTING.md - Contribution guidelines and pull request process
Directory Structure
dx-toolkit/
āāā marketplace.json # Plugin marketplace manifest
āāā packages/
ā āāā mcp/ # MCP Server package
ā āāā ai-sdk-plugin/ # Vercel AI SDK plugin
ā āāā teams-anthropic/ # Teams.ai Anthropic integration
ā āāā src/ # Source code
ā āāā dist/ # Compiled output
ā āāā templates/ # Code templates
ā āāā README.md # User documentation
ā āāā AGENTS.md # Package dev guide
ā āāā package.json # Package config
āāā plugins/ # Claude Code plugins
ā āāā teams-anthropic-integration/
ā āāā .claude-plugin/
ā āāā commands/
ā āāā src/
ā āāā templates/
ā āāā AGENTS.md # Plugin instructions
ā āāā README.md # Plugin docs
āāā .github/
ā āāā workflows/ # CI/CD workflows
āāā docs/
ā āāā MARKETPLACE.md # Marketplace documentation
āāā AGENTS.md # Monorepo dev guide
āāā package.json # Workspace root config
āāā README.md # This file
Roadmap
Plugins in Development (Target: Q1 2026)
- google-chat-mcp-integration - Google Chat apps with You.com MCP server
- eval-harness - Evaluation harness for MCP tools (includes skills)
- local-rag-sqlite - Local RAG with SQLite backend (includes skills)
- cloud-deployment - Cloud-agnostic deployment automation (includes skills)
- rl-pipeline - Reinforcement learning pipeline starter (includes skills)
Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
License
MIT - See LICENSE for details
Support
- Documentation: MCP Server Docs
- Issues: GitHub Issues
- Email: support@you.com
- Web: You.com Support
Built with ā¤ļø by You.com
@youdotcom-oss/mcpnpm install @youdotcom-oss/mcp