[Integration] TanStack/cli — You.com MCP server and search capabilities

[mouse-value-add]

Target Repository URL

https://github.com/TanStack/cli

You.com API(s)

MCP server registration (you-search, you-contents, you-research via MCP server)

Estimated Complexity

small

Integration Description

TanStack CLI is the official CLI for the TanStack ecosystem (1,292⭐) with project scaffolding, MCP server capabilities, and agent skills installation features. The CLI description explicitly mentions "MCP Server, Agent Skills Installation" but currently removed its MCP server in favor of CLI introspection.

This integration adds You.com MCP server configuration to TanStack CLI's skills system, enabling developers using TanStack Router/Start to access You.com's search, content extraction, and research capabilities directly through the CLI's agent integration features.

TanStack CLI already has sophisticated command architecture including libraries, search-docs, ecosystem commands, and a skills directory in the package manifest. The integration leverages this existing infrastructure.

Target Repo Contributing Guidelines

https://github.com/TanStack/cli/blob/main/CONTRIBUTING.md

Planned Approach

1. Skills Directory: Create the CLI's skills directory referenced in package.json and add You.com skill manifests following the Agent Skills format

2. MCP Configuration: Add You.com MCP server entries to the CLI's skill configuration system:

   • you-authenticated: Full authenticated You.com MCP server (https://api.you.com/mcp)
   • you-free: Keyless free tier MCP server (https://api.you.com/mcp?profile=free)
   • you-docs: You.com docs search MCP server (https://you.com/docs/_mcp/server)

3. CLI Integration: Extend existing CLI commands to support You.com capabilities:

   • Add You.com search option to search-docs command
   • Include You.com in ecosystem command output
   • Enable You.com skills installation via add command

4. Follow Existing Pattern: Mirror the structure of TanStack's existing skill/MCP patterns and CLI command architecture.

The integration leverages TanStack CLI's existing skills and MCP infrastructure rather than adding custom code, making it a clean addition to the established CLI ecosystem.

Status Checklist

• Claimed this integration (self-assign)
• Filed issue or opened discussion in target repo
• Opened PR in target repo
• You.com API calls send the standard integration User-Agent (handled by MCP server)
• You.com links in contributed docs carry the standard UTM parameters
• PR merged or rejected

Links

Target repo PR: TanStack/cli#504
Source branch: https://github.com/mouse-value-add/cli-1/tree/feat/youcom-mcp-integration

Integration Implementation Summary

Integration Type: MCP server configuration + CLI commands
Distribution Surface: TanStack CLI skills system + new youcom command group
Files Added:

• packages/cli/skills.json - MCP server definitions
• packages/cli/skills/you-web/SKILL.md - Web search skill
• packages/cli/skills/you-discover/SKILL.md - Discovery skill
• packages/cli/src/youcom-search.ts - You.com API integration
• Updated packages/cli/src/cli.ts - New CLI commands
• Updated README.md - Documentation and examples

CLI Commands Added:

• npx @tanstack/cli youcom config - Show MCP server configuration
• npx @tanstack/cli youcom install - Install You.com skills
• npx @tanstack/cli youcom search <query> - Search You.com API

MCP Servers Configured:

• you-com: Authenticated server (https://api.you.com/mcp)
• you-com-free: Keyless server (https://api.you.com/mcp?profile=free)
• you-docs: Docs server (https://you.com/docs/_mcp/server)

Validation Performed:

• ✅ All unit tests pass (351 tests)
• ✅ Build succeeds
• ✅ CLI commands functional
• ✅ MCP configuration valid
• ✅ JSON output working
• ✅ Error handling verified

Setup Requirements:

• Optional: Set YDC_API_KEY environment variable for authenticated features
• No breaking changes, fully opt-in functionality

Additional Notes

Perfect distribution surface fit: TanStack CLI explicitly supports MCP servers and agent skills installation. The CLI's package.json includes a skills directory and the project description mentions MCP server capabilities, making this the ideal integration surface.

High visibility platform: TanStack is a major JavaScript ecosystem with Router, Query, Table, Form, and other widely-used libraries. The CLI serves developers across the entire TanStack ecosystem.

Leverages existing distribution: Can reuse agent-skills repo artifacts while integrating them into TanStack's native CLI skill system.

Community precedent: TanStack previously had MCP server integration but moved to CLI introspection. Adding optional You.com MCP capabilities through the skills system provides a clean path back to MCP integration.

Zero breaking changes: Pure additive integration through the existing skills directory and CLI command structure.

[mouse-value-add]

PR Update: Addressed all CodeRabbit review feedback in TanStack/cli#504

• Fixed import ordering, array types, function naming to match repo conventions
• Updated API endpoint to use correct ydc-index.io/v1/search with POST method
• Added security sanitization for terminal control sequences
• Updated skill documentation and README with proper You.com MCP endpoints
• Renamed installation function to clarify it provides instructions only

PR now ready for maintainer review. All technical feedback has been resolved.