@youdotcom-oss/cli
v1.0.0
Published
Agent-first CLI bridge for the hosted You.com MCP server
Readme
@youdotcom-oss/cli
Agent-first CLI for the hosted You.com MCP server.
The CLI is a thin bridge over remote MCP:
ydc toolsydc schema <tool> [input|output]ydc <tool> <json>
It does not contain local per-tool REST logic or local schema validation.
Install
bun add -g @youdotcom-oss/cliOr run it without installing:
bunx @youdotcom-oss/cli toolsCommands
List the locally allowlisted tool ids:
ydc toolsFetch raw remote schema for a tool:
ydc schema you-search
ydc schema you-search outputExecute a remote tool with JSON input:
ydc you-search '{"query":"latest bun release"}'
echo '{"query":"latest bun release"}' | ydc you-searchFlags
--api-key <key>Uses that API key instead ofYDC_API_KEY.--dry-runPrints the resolved URL, tool id, sanitized headers, and JSON arguments.--profile freeSupported only foryou-search. In this mode the CLI routes to?profile=freeand strips auth headers.
Environment
YDC_API_KEYOptional default API key.
Notes
ydc toolsis local/offline and reads the checked-in contract fromsrc/tools.ts.ydc schema ...and tool execution create a fresh MCP client per invocation.- Tool ids are literal remote MCP tool ids such as
you-searchandyou-contents. - CLI requests always target the hosted base MCP URL at
https://api.you.com/mcp.
