NAME

App::Raider::WebTools - MCP::Server factory with web search and fetch tools (Net::Async::WebSearch + Net::Async::HTTP)

VERSION

version 0.003

build_web_tools_server

my $server = App::Raider::WebTools::build_web_tools_server(
    loop           => $loop,         # required
    max_fetch_bytes => 2_000_000,
);

Returns an MCP::Server instance with two tools:

  • web_search(query, [limit]) -- multi-provider search via Net::Async::WebSearch. DuckDuckGo is always enabled (keyless). Brave, Serper and Google are auto-added when BRAVE_API_KEY, SERPER_API_KEY, or both GOOGLE_API_KEY + GOOGLE_CSE_ID are set in the environment.

  • web_fetch(url) -- fetch a URL via Net::Async::HTTP. Returns the response body (HTML is flattened to readable text, up to max_fetch_bytes).

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-app-raider/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.