Skip to content
Back to search

RivalSearchMCP

Deterministic research MCP server on FastMCP 3 — 5-engine web search, 9-platform social search, 6 academic DBs, news aggregation, entity profiles, conflict detection, document analysis. No API keys. No in-server LLM. Structured outputs for agent chaining.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/damionrashford/RivalSearchMCP with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/damionrashford/RivalSearchMCP'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/damionrashford--rivalsearchmcp/badge.svg)](/listings/damionrashford--rivalsearchmcp)

HTML

<a href="/listings/damionrashford--rivalsearchmcp"><img src="/api/listings/damionrashford--rivalsearchmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Prerequisites:**

# Install UV (modern Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install FastMCP CLI (optional but recommended)
uv tool install fastmcp

**Method 1: One-Command Install (Easiest)**

# Clone repository
git clone https://github.com/damionrashford/RivalSearchMCP.git
cd RivalSearchMCP

# Install directly to your MCP client:
fastmcp install claude-desktop server.py   # For Claude Desktop
fastmcp install cursor server.py           # For Cursor
fastmcp install claude-code server.py      # For Claude Code

**Method 2: Quick Run (No Installation)**

git clone https://github.com/damionrashford/RivalSearchMCP.git
cd RivalSearchMCP

# Run directly with FastMCP CLI
fastmcp run server.py  # Auto-detects entrypoint, uses STDIO

# Or run in HTTP mode for testing
fastmcp run server.py --transport http --port 8000

**Method 3: Development with Inspector**

# Run with MCP Inspector for testing
fastmcp dev server.py

**Method 4: Manual UV Setup**

git clone https://github.com/damionrashford/RivalSearchMCP.git
cd RivalSearchMCP
uv sync

# Add to Claude Desktop or Cursor config:
{
  "RivalSearchMCP": {
    "command": "uv",
    "args": [
      "--directory",
      "/full/path/to/RivalSearchMCP",
      "run",
      "python",
      "server.py"
    ]
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 24 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "rivalsearchmcp",
  3. "description": "Multi-engine research tools for Claude Code — web, social, news, academic, GitHub, and document processing. No API keys.",
  4. "owner": {
  5. "name": "Damion Rashford",
  6. "url": "https://github.com/damionrashford"
  7. },
  8. "plugins": [
  9. {
  10. "name": "rival-search-mcp",
  11. "description": "9 research tools: 5-engine web search, 9 social platforms, 5 news sources, 5 academic databases, GitHub, website mapping, document analysis, and research topic synthesis. No API keys required.",
  12. "source": "./plugins/rival-search-mcp",
  13. "category": "search",
  14. "tags": ["research", "mcp", "no-auth"]
  15. },
  16. {
  17. "name": "rival-search-mcp-skills",
  18. "description": "Agent skill and CLI helpers for RivalSearchMCP research workflows. Install separately from the MCP server plugin.",
  19. "source": "./plugins/rival-search-mcp-skills",
  20. "category": "search",
  21. "tags": ["research", "skills", "cli"]
  22. }
  23. ]
  24. }
README.md · README · 388 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # RivalSearchMCP
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)
  3. ![MCP Server](https://img.shields.io/badge/MCP-Server-blue?style=for-the-badge)
  4. ![Python](https://img.shields.io/badge/Python-3.10+-3776AB?logo=python&logoColor=white&style=for-the-badge)
  5. ![FastMCP](https://img.shields.io/badge/FastMCP-3.2+-green?style=for-the-badge)
  6. [![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?logo=linkedin&style=for-the-badge)](https://www.linkedin.com/in/damion-rashford)
  7. ![GitHub Stars](https://img.shields.io/github/stars/damionrashford/RivalSearchMCP?style=social)
  8. ![GitHub Forks](https://img.shields.io/github/forks/damionrashford/RivalSearchMCP?style=social)
  9. ![GitHub Issues](https://img.shields.io/github/issues/damionrashford/RivalSearchMCP?style=social)
  10. ![Last Commit](https://img.shields.io/github/last-commit/damionrashford/RivalSearchMCP?style=social)
  11. ![Visitor Count](https://visitor-badge.laobi.icu/badge?page_id=damionrashford.RivalSearchMCP)
  12. **Deterministic research MCP server — web + social + academic + news + code + docs, all in one place. No API keys, no in-server LLM, structured outputs for agent chaining.**
  13. > 🆓 **100% Free & Open Source** — No API keys or subscriptions for core tools. The hosted server includes fair-use rate limiting.
  14. ## What It Does
  15. RivalSearchMCP is a FastMCP 3.x server exposing **9 specialized tools** that search, fetch, score, and compare information across:
  16. - **5 web search engines** (DuckDuckGo, Bing, Yahoo, Mojeek, Wikipedia) — concurrent, deduplicated, with TLS-fingerprint-safe fetches via Scrapling
  17. - **9 social platforms** (Reddit, Hacker News, Stack Overflow, Dev.to, Medium, Product Hunt, Bluesky, Lobste.rs, Lemmy) — no authentication
  18. - **5 news sources** (Google News, Bing News, The Guardian, GDELT, DuckDuckGo News) — with time-range filtering
  19. - **5 academic databases** (OpenAlex, CrossRef, arXiv, PubMed, Europe PMC) + **4 dataset hubs** (Kaggle, HuggingFace, Dataverse, Zenodo)
  20. - **GitHub repositories** with built-in rate limiting
  21. - **Documents** (PDF, Word, text, images) with OCR for images
  22. - **Website traversal** with research, docs, and mapping modes
  23. **No LLM runs inside the server.** Every tool returns deterministic, auditable output — the caller's model does the synthesis. Tools that benefit from structured output (`content_operations score`, `find_conflicts`) return `ToolResult` with both a human-readable markdown rendering and a parseable `structuredContent` dict, so agents can chain tool outputs without regex-parsing prose.
  24. ## ✅ Why It's Useful
  25. - **One connection, nine tools** — no need to wire up separate MCP servers per source
  26. - **Auto-quality scoring** — every result carries a tier/freshness/corroboration/citation score (0-100) and every multi-result response carries an aggregate confidence signal
  27. - **Conflict detection** — `content_operations find_conflicts` surfaces numeric, date, and polarity disagreements across sources as a first-class signal instead of averaging them away
  28. - **Entity profiles** — `research_topic(mode="entity")` fans out to 8 sources in parallel and returns a unified report with confidence
  29. - **Production hygiene** — per-tool timeouts, rate limiting (100 req/min/session), response-size caps, error masking, middleware-level observability
  30. ## 💡 Example Query
  31. Once connected, try asking your AI assistant:
  32. > "Use RivalSearchMCP to research FastAPI vs Django. Run `research_topic` on both, aggregate recent news, check Reddit and Hacker News discussions, search GitHub for activity, look for academic papers, score the top sources, and flag any conflicts between them."
  33. ## 📦 How to Get Started
  34. RivalSearchMCP runs as a **remote MCP server** hosted on FastMCP. Just follow the steps below to install, and go.
  35. ### Connect to Live Server
  36. [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=RivalSearchMCP&config=eyJ1cmwiOiJodHRwczovL1JpdmFsU2VhcmNoTUNQLmZhc3RtY3AuYXBwL21jcCJ9)
  37. Or add this configuration manually:
  38. **For Cursor:**
  39. ```json
  40. {
  41. "mcpServers": {
  42. "RivalSearchMCP": {
  43. "url": "https://RivalSearchMCP.fastmcp.app/mcp"
  44. }
  45. }
  46. }
  47. ```
  48. **For Claude Desktop:**
  49. - Go to Settings → Add Remote Server
  50. - Enter URL: `https://RivalSearchMCP.fastmcp.app/mcp`
  51. **For VS Code:**
  52. - Add the above JSON to your `.vscode/mcp.json` file
  53. **For Claude Code:**
  54. - Use the built-in MCP management: `claude mcp add RivalSearchMCP --url https://RivalSearchMCP.fastmcp.app/mcp`
  55. ### Local Installation with FastMCP CLI
  56. **Prerequisites:**
  57. ```bash
  58. # Install UV (modern Python package manager)
  59. curl -LsSf https://astral.sh/uv/install.sh | sh
  60. # Install FastMCP CLI (optional but recommended)
  61. uv tool install fastmcp
  62. ```
  63. **Method 1: One-Command Install (Easiest)**
  64. ```bash
  65. # Clone repository
  66. git clone https://github.com/damionrashford/RivalSearchMCP.git
  67. cd RivalSearchMCP
  68. # Install directly to your MCP client:
  69. fastmcp install claude-desktop server.py # For Claude Desktop
  70. fastmcp install cursor server.py # For Cursor
  71. fastmcp install claude-code server.py # For Claude Code
  72. ```
  73. **Method 2: Quick Run (No Installation)**
  74. ```bash
  75. git clone https://github.com/damionrashford/RivalSearchMCP.git
  76. cd RivalSearchMCP
  77. # Run directly with FastMCP CLI
  78. fastmcp run server.py # Auto-detects entrypoint, uses STDIO
  79. # Or run in HTTP mode for testing
  80. fastmcp run server.py --transport http --port 8000
  81. ```
  82. **Method 3: Development with Inspector**
  83. ```bash
  84. # Run with MCP Inspector for testing
  85. fastmcp dev server.py
  86. ```
  87. **Method 4: Manual UV Setup**
  88. ```bash
  89. git clone https://github.com/damionrashford/RivalSearchMCP.git
  90. cd RivalSearchMCP
  91. uv sync
  92. # Add to Claude Desktop or Cursor config:
  93. {
  94. "RivalSearchMCP": {
  95. "command": "uv",
  96. "args": [
  97. "--directory",
  98. "/full/path/to/RivalSearchMCP",
  99. "run",
  100. "python",
  101. "server.py"
  102. ]
  103. }
  104. }
  105. ```
  106. ## 🛠 Available Tools (9 Total)
  107. Every tool carries `ToolAnnotations` (`readOnlyHint`, `openWorldHint`, `destructiveHint`, `idempotentHint`) so MCP clients like Claude and ChatGPT can skip confirmation prompts where safe. Every tool has a `timeout=` ceiling so a hung source can't stall the client.
  108. ### Search & Discovery (5 tools)
  109. - **`web_search`** — concurrent multi-engine search across DuckDuckGo, Bing, Yahoo, Mojeek, and Wikipedia. Scrapling-backed TLS fingerprinting bypasses Cloudflare/Akamai fronting. Per-engine failures don't block the others.
  110. - **`social_search`** — 9 platforms: Reddit, Hacker News, Stack Overflow, Dev.to, Medium, Product Hunt, Bluesky, Lobste.rs, Lemmy. No authentication.
  111. - **`news_aggregation`** — 5 sources: Google News, Bing News, The Guardian, GDELT, DuckDuckGo News. Accepts `time_range` (day/week/month/anytime).
  112. - **`github_search`** — repository search with built-in rate limiting (60/hr unauthenticated), optional README inclusion.
  113. - **`map_website`** — traverse a site in `research`, `docs`, or `map` mode; returns per-page quality scores and an aggregate confidence signal.
  114. ### Content Analysis (3 tools)
  115. - **`content_operations`** — one tool, six operations: `retrieve`, `stream`, `analyze`, `extract`, `score`, `find_conflicts`.
  116. - `score` rates URLs on tier / freshness / corroboration / citations (0-100) and returns both markdown + structured JSON.
  117. - `find_conflicts` compares 2-10 sources for numeric / date / polarity disagreements with confidence weights.
  118. - **`research_topic`** — two modes: `topic` (search + fetch + relevance-ranked key findings) and `entity` (unified cross-source profile of a named entity, fanning out to web / news / GitHub / social / academic in parallel).
  119. - **`document_analysis`** — extract text from PDF, Word, plain text, and images. Images use EasyOCR (lazy-loaded; no setup). 50 MB cap.
  120. ### Research Workflow (1 tool)
  121. - **`scientific_research`** — academic paper and dataset search. 5 paper providers (OpenAlex, CrossRef, arXiv, PubMed, Europe PMC) and 4 dataset hubs (Kaggle, HuggingFace, Dataverse, Zenodo).
  122. ## Plugins
  123. RivalSearchMCP ships as an installable plugin for both **Claude Code** and **OpenAI Codex**. The plugin registers the hosted MCP server at `https://RivalSearchMCP.fastmcp.app/mcp`, so users do not need to clone this repo or run a local server.
  124. The GitHub repo is the plugin marketplace. Add the marketplace once, then install either or both plugins:
  125. - `rival-search-mcp` registers the hosted MCP server and exposes the 9 tools.
  126. - `rival-search-mcp-skills` installs the standalone agent skill, reference docs, and CLI helpers.
  127. ### Claude Code
  128. From a terminal:
  129. ```bash
  130. # 1. Add this repo as a marketplace
  131. claude plugin marketplace add damionrashford/RivalSearchMCP --scope user
  132. # 2. Install the plugin
  133. claude plugin install rival-search-mcp@rivalsearchmcp --scope user
  134. # Optional: install the skill-only plugin
  135. claude plugin install rival-search-mcp-skills@rivalsearchmcp --scope user
  136. ```
  137. Inside Claude Code, the same flow is available with slash commands:
  138. ```text
  139. /plugin marketplace add damionrashford/RivalSearchMCP
  140. /plugin install rival-search-mcp@rivalsearchmcp
  141. /plugin install rival-search-mcp-skills@rivalsearchmcp
  142. ```
  143. For a team/project install, use `--scope project` instead of `--scope user`, or add the marketplace to `.claude/settings.json`:
  144. ```json
  145. {
  146. "extraKnownMarketplaces": {
  147. "rivalsearchmcp": {
  148. "source": {
  149. "source": "github",
  150. "repo": "damionrashford/RivalSearchMCP"
  151. }
  152. }
  153. }
  154. }
  155. ```
  156. Then install one or both plugins with `/plugin install rival-search-mcp@rivalsearchmcp` and `/plugin install rival-search-mcp-skills@rivalsearchmcp`.
  157. Once installed, Claude Code exposes the MCP tools as `mcp__RivalSearchMCP__*`. Example prompts:
  158. ```text
  159. Use RivalSearchMCP to search recent news about open source AI agents.
  160. Use RivalSearchMCP to compare FastAPI and Django across web, GitHub, and academic sources.
  161. Use RivalSearchMCP to retrieve this URL, score the source, and identify conflicting claims.
  162. ```
  163. ### OpenAI Codex
  164. ```bash
  165. # 1. Add this repo as a marketplace
  166. codex plugin marketplace add damionrashford/RivalSearchMCP --ref main
  167. # 2. Install the plugin
  168. codex plugin add rival-search-mcp@rival-search-mcp-marketplace
  169. # Optional: install the skill-only plugin
  170. codex plugin add rival-search-mcp-skills@rival-search-mcp-marketplace
  171. ```
  172. Once installed, start or refresh a Codex session and ask Codex to use RivalSearchMCP. Example prompts:
  173. ```text
  174. Use RivalSearchMCP to run web_search for current MCP server comparisons.
  175. Use RivalSearchMCP to research this company across news, GitHub, and social sources.
  176. Use RivalSearchMCP to find scientific papers about retrieval augmented generation.
  177. ```
  178. If you already added the marketplace and want the latest plugin metadata:
  179. ```bash
  180. codex plugin marketplace upgrade
  181. ```
  182. ### Plugin structure
  183. ```
  184. plugins/rival-search-mcp/
  185. ├── .claude-plugin/
  186. │ └── plugin.json # Claude Code manifest
  187. ├── .codex-plugin/
  188. │ └── plugin.json # Codex manifest
  189. └── .mcp.json # Registers https://RivalSearchMCP.fastmcp.app/mcp
  190. plugins/rival-search-mcp-skills/
  191. ├── .claude-plugin/
  192. │ └── plugin.json # Claude Code skill plugin manifest
  193. ├── .codex-plugin/
  194. │ └── plugin.json # Codex skill plugin manifest
  195. └── skills/
  196. └── rival-search-mcp/ # Agent skill, resources, and CLI helper
  197. ```
  198. Marketplace catalogs at:
  199. - `.claude-plugin/marketplace.json` — Claude Code
  200. - `.agents/plugins/marketplace.json` — Codex
  201. Plugin package:
  202. - `plugins/rival-search-mcp/.claude-plugin/plugin.json` — Claude Code manifest
  203. - `plugins/rival-search-mcp/.codex-plugin/plugin.json` — Codex manifest
  204. - `plugins/rival-search-mcp/.mcp.json` — hosted MCP server registration
  205. - `plugins/rival-search-mcp-skills/skills/rival-search-mcp/` — standalone agent skill package
  206. ---
  207. ## Agent Skills
  208. RivalSearchMCP ships with a **Claude Code Agent Skill** — a self-contained CLI that lets AI agents use all 9 tools without MCP configuration.
  209. ### Use as a Claude Code Skill
  210. Copy the skill into your Claude Code skills directory:
  211. ```bash
  212. # Project-level (available when working in this repo)
  213. cp -r skills/rival-search-mcp .claude/skills/
  214. # Global (available in all projects)
  215. cp -r skills/rival-search-mcp ~/.claude/skills/
  216. ```
  217. Claude will automatically discover the skill and use the CLI when you ask for web research, competitor analysis, or content discovery.
  218. ### Use the CLI directly
  219. The CLI is self-contained with inline dependencies — just run with `uv`:
  220. ```bash
  221. uv run skills/rival-search-mcp/scripts/cli.py call-tool web_search --query "your query"
  222. uv run skills/rival-search-mcp/scripts/cli.py call-tool social_search --query "AI agents" --platforms reddit
  223. uv run skills/rival-search-mcp/scripts/cli.py call-tool news_aggregation --query "tech news" --time-range week
  224. uv run skills/rival-search-mcp/scripts/cli.py list-tools
  225. ```
  226. ### Skill structure
  227. ```
  228. skills/rival-search-mcp/
  229. ├── SKILL.md # Agent instructions (auto-loaded by Claude Code)
  230. ├── scripts/
  231. │ └── cli.py # Standalone CLI with all 9 tools
  232. └── resources/
  233. ├── search.md # web_search, social_search, news_aggregation, github_search, map_website
  234. ├── content.md # content_operations, document_analysis
  235. └── research.md # research_topic, scientific_research
  236. ```
  237. ## ⚡ Key Features
  238. - **Multi-Engine Search**: 5 search engines (DuckDuckGo, Bing, Yahoo, Mojeek, Wikipedia) with TLS-fingerprint-safe fetches via Scrapling
  239. - **9-Platform Social Research**: Reddit, Hacker News, Stack Overflow, Dev.to, Medium, Product Hunt, Bluesky, Lobste.rs, Lemmy
  240. - **5-Source News Aggregation**: Google News, Bing News, The Guardian, GDELT, DuckDuckGo News — with time-range filtering
  241. - **5 Academic Databases + 4 Dataset Hubs**: OpenAlex, CrossRef, arXiv, PubMed, Europe PMC + Kaggle, HuggingFace, Dataverse, Zenodo
  242. - **Deterministic Output**: no LLM runs inside the server; callers' models do the synthesis
  243. - **Structured `ToolResult`**: `content_operations score` and `find_conflicts` return both markdown (for humans) and parseable JSON (for agent chaining)
  244. - **Auto-Quality Scoring**: every multi-result tool attaches per-item quality (0-100) and an aggregate confidence signal
  245. - **Conflict Detection**: finds numeric/date/polarity disagreements across sources with confidence weights
  246. - **Document Analysis**: PDF / Word / text / images (images via EasyOCR, auto-downloaded)
  247. - **Production Hygiene**: per-tool timeouts, sliding-window rate limiting, response-size caps, error masking, FastMCP 3.x middleware stack
  248. - **Zero Authentication**: every tool works without API keys or setup.
  249. ## 💬 FAQ
  250. <details>
  251. <summary><strong>Is RivalSearchMCP really free?</strong></summary>
  252. Yes. RivalSearchMCP is free and open source under the MIT License. The core tools do not require paid APIs or subscriptions. The hosted server applies fair-use rate limiting; you can self-host if you need different limits.
  253. </details>
  254. <details>
  255. <summary><strong>Do I need API keys?</strong></summary>
  256. No. RivalSearchMCP works completely without any API keys, authentication, or configuration. Just add the URL and use all 9 tools immediately.
  257. </details>
  258. <details>
  259. <summary><strong>What MCP clients are supported?</strong></summary>
  260. RivalSearchMCP works with any MCP-compatible client including Claude Desktop, Cursor, VS Code, and Claude Code.
  261. </details>
  262. <details>
  263. <summary><strong>Can I self-host this?</strong></summary>
  264. Yes. Clone the repo, run `uv sync --extra dev`, then `fastmcp run` (stdio) or `fastmcp run --transport http --host 0.0.0.0 --port 8000` (HTTP). Full instructions are in the Getting Started section above.
  265. </details>
  266. <details>
  267. <summary><strong>Why is there no in-server LLM / research agent?</strong></summary>
  268. Deliberately. The server returns deterministic, auditable output so the caller's model can reason over it — a consistent machine can't hallucinate the way a synthesizing one can. If you want an autonomous agent loop, run it in your client.
  269. </details>
  270. ## 🤝 Contributing
  271. Contributions are welcome! Whether it's fixing bugs, adding new research tools, or improving documentation, your help is appreciated.
  272. 1. **Fork the Project**
  273. 2. **Create your Feature Branch** (`git checkout -b feature/AmazingFeature`)
  274. 3. **Commit your Changes** (`git commit -m 'Add some AmazingFeature'`)
  275. 4. **Push to the Branch** (`git push origin feature/AmazingFeature`)
  276. 5. **Open a Pull Request**
  277. ## 💡 Issues, Feedback & Support
  278. Found a bug, have a feature request, or want to share how you're using RivalSearchMCP? We'd love to hear from you!
  279. - **Report a bug** — Help us improve by reporting issues
  280. - **Request a feature** — Suggest new capabilities you'd find useful
  281. - **Share your use case** — Tell us how you're using RivalSearchMCP
  282. 👉 **[Open an Issue](https://github.com/damionrashford/RivalSearchMCP/issues)**
  283. ## Attribution & License
  284. This is an open source project under the **MIT License**. If you use RivalSearchMCP, please credit it by linking back to [RivalSearchMCP](https://github.com/damionrashford/RivalSearchMCP). See [LICENSE](LICENSE) file for details.
  285. ## ⭐ Like this project? Give it a star!
  286. If you find RivalSearchMCP useful, please consider giving it a star. It helps others discover the project and motivates continued development!
  287. [![Star this repo](https://img.shields.io/github/stars/damionrashford/RivalSearchMCP?style=social)](https://github.com/damionrashford/RivalSearchMCP)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.