RivalSearchMCP

You have access to 9 research tools via the CLI at scripts/cli.py. Run all commands with uv run scripts/cli.py.

Every tool returns deterministic, auditable output. There is no in-server LLM — you're the one doing the synthesis.

How to invoke tools

uv run scripts/cli.py call-tool <tool_name> --flag value

web_search — concurrent search across DuckDuckGo, Bing, Yahoo, Mojeek, Wikipedia. Use for general web queries.
social_search — Reddit, Hacker News, Stack Overflow, Dev.to, Medium, Product Hunt, Bluesky, Lobste.rs, Lemmy. Use for community discussions.
news_aggregation — Google News, Bing News, The Guardian, GDELT, DuckDuckGo News. Use for current events. Accepts --time-range day|week|month|anytime.
github_search — search public GitHub repos. Use for code, libraries, projects.
map_website — crawl a site in research / docs / map mode. Use to explore site structure or documentation.
content_operations — one tool, six ops (retrieve, stream, analyze, extract, score, find_conflicts). Use to get full page content, rate source quality, or surface disagreements between sources.
document_analysis — extract text from PDFs, Word docs, images (image OCR via EasyOCR). Use for document processing.
research_topic — end-to-end research workflow for a topic, combining search, content retrieval, and analysis.
scientific_research — OpenAlex, CrossRef, arXiv, PubMed, Europe PMC (papers) + Kaggle, HuggingFace, Dataverse, Zenodo (datasets).

Found a URL from search? → content_operations --operation retrieve --url <url>
Want to assess source trust before using results? → content_operations --operation score --urls '[…]'
Two sources seem to disagree? → content_operations --operation find_conflicts --urls '[…]'
Found a PDF link? → document_analysis --url <url>
Need to explore a website? → map_website --url <url> --mode docs
Need a unified entity profile in one shot? → research_topic --mode entity --topic "OpenAI"

For full flags, types, and defaults for each tool, read:

resources/search.md — web_search, social_search, news_aggregation, github_search, map_website
resources/content.md — content_operations, document_analysis
resources/research.md — research_topic, scientific_research

All tools return structured text to stdout. Errors go to stderr. Exit codes: 0 success, 1 tool error, 2 connection failed.