feat: add you.com search provider

[mouse-value-add]

Hi maintainers, thanks for building MCPAgent, the custom-tools path makes provider integrations very straightforward.

I chose this repo because it is an actively maintained agent runtime where web search is a natural capability, and there was not yet a concrete example for integrating you.com Search API as a custom provider/tool.

What changed

• Added a new example:
  • : registers a custom tool and calls the you.com Search API via direct HTTP ()
  • : setup, env vars, run instructions, and usage examples
  • / : example module dependencies
  • : minimal MCP config for running the example
• Updated top-level example lists to include the new you.com example.

Setup

is optional for Search API free-tier usage, but recommended for stable production behavior.

Fallback and error handling included

• If unauthenticated usage hits //, tool returns a friendly fallback message instructing to set
• Empty returns a non-error informational message
• Non-2xx responses bubble status/body context for debugging

Validation

• I formatted the new example and attempted to build it from the example module.
• In this environment, build currently fails in upstream due an existing unrelated compile issue in ( symbol mismatch), so I could not complete a clean end-to-end build run here.

Why this helps agent intelligence

This gives users a low-friction path to add fresh web-grounded retrieval directly into MCPAgent workflows without additional SDK dependencies, while keeping integration scope narrow and maintainable.

This is backward-compatible and additive only. Happy to adjust structure, naming, or docs placement if you prefer a different convention.