Agent skill

Rival Search MCP

by damionrashford in damionrashford/RivalSearchMCP

Deterministic deep research via RivalSearchMCP. An agent skill from damionrashford/RivalSearchMCP.

MITAuto-check passedResearch & Science

Install Rival Search MCP

skills CLI
$ npx skills add damionrashford/RivalSearchMCP --skill rival-search-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install damionrashford/RivalSearchMCP rival-search-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/damionrashford/RivalSearchMCP.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/rival-search-mcp .claude/skills/rival-search-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
rival-search-mcp
GitHub stars
132
Token cost
~796 tokens
SKILL.md length
295 words
Files
5 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Deterministic deep research via RivalSearchMCP. An agent skill from damionrashford/RivalSearchMCP.

  • The user needs web research
  • SKILL.md covers How to invoke tools, Available tools, When to chain tools and Tool reference, plus 1 more section
  • Runs Python scripts from its folder; calls uv
  • Competitive analysis

What it does

Rival Search MCP is an agent skill from damionrashford/RivalSearchMCP. Deterministic deep research via RivalSearchMCP. 9 tools: 5-engine web search (DuckDuckGo/Bing/Yahoo/Mojeek/Wikipedia), 9-platform social search (Reddit/HN/StackOverflow/Dev.to/Medium/ProductHunt/Bluesky/Lobste.rs/Lemmy), 5-source news (Google/Bing/Guardian/GDELT/DDG), 5 academic DBs (OpenAlex/CrossRef/arXiv/PubMed/EuropePMC), GitHub search, website mapping, content extraction with OCR, and research topic synthesis. No API keys required. Use when the user needs web research, competitive analysis, content…

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `resources/content.md`, `resources/research.md` and `resources/search.md`).

It sits in Research & Science, covering Academic paper search, Deep research and Competitor analysis. It works with Model Context Protocol, GitHub, arXiv and PubMed. The repository describes itself as: 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… The licence is MIT.

When your agent uses it

  • The user needs web research
  • Competitive analysis
  • Content discovery
  • Academic paper search

Example prompts

  • “/rival-search-mcp”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 3540fa5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Rival Search MCP loads about 796 tokens when it runs. Until then it costs about 141 tokens; SKILL.md has 295 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~796

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from damionrashford/RivalSearchMCP at commit 3540fa5, republished under its MIT licence (© damionrashford). 295 words, ~796 tokens.

Download SKILL.mdSave it as .claude/skills/rival-search-mcp/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
rival-search-mcp
description
Deterministic deep research via RivalSearchMCP. 9 tools: 5-engine web search (DuckDuckGo/Bing/Yahoo/Mojeek/Wikipedia), 9-platform social search (Reddit/HN/StackOverflow/Dev.to/Medium/ProductHunt/Bluesky/Lobste.rs/Lemmy), 5-source news (Google/Bing/Guardian/GDELT/DDG), 5 academic DBs (OpenAlex/CrossRef/arXiv/PubMed/EuropePMC), GitHub search, website mapping, content extraction with OCR, and research topic synthesis. No API keys required. Use when the user needs web research, competitive analysis, content discovery, or academic paper search.

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

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

Available tools

  • 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).

When to chain tools

  • 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"

Tool reference

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

Output

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

© damionrashford, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in skills/rival-search-mcp of damionrashford/RivalSearchMCP.

  • SKILL.md
  • resources/content.md
  • resources/research.md
  • resources/search.md
  • scripts/cli.py

Open the folder on GitHubat commit 3540fa5

Compare with similar skills

Rival Search MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Rival Search MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Rival Search MCP this skilldamionrashford/RivalSearchMCP132—~796Automated safety check: PassMIT
Local Search Fallbacktaxueseek/argo188—~949Automated safety check: PassMIT
Paper Searchopenags/paper-search-mcp2.8k—~1.2kAutomated safety check: NotesMIT
Nature Academic Searchwp-a/nature-academic-search304—~1.4kAutomated safety check: PassMIT
Paper Searchopenags/paper-search-mcp2.8k—~794Automated safety check: NotesMIT
Academic Search and Citation RouterYuan1z0825/nature-skills47k—~884Automated safety check: PassApache-2.0

Similar skills

  • Local Search Fallback

    taxueseek/argo

    Zero-cost fallback for the argo search skill, wrapping 29 local engines for web, news, academic, code and reference queries when paid API quota should be saved.

    188 GitHub stars~949 tokensUpdated 4 days ago
    Productivity & AutomationAuto-check passed
  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc).

    2.8k GitHub stars~1.2k tokensUpdated 9 days ago
    Research & ScienceAuto-check: notes
  • Nature Academic Search

    wp-a/nature-academic-search

    A skill your agent uses when users ask to 找文献、做文献检索、查论文、查临床试验、核验引用、去重文献、设计 PubMed/MeSH 检索式、追踪上下游引文、解析 DOI/PMID/PMCID/arXiv/OpenAlex/Semantic Scholar/NCT ID, 或导出 RIS、BibTeX、NBIB、ENW;also use for…

    304 GitHub stars~1.4k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers through the paper-search MCP tools (mcppaper-search), covering arXiv, PubMed, bioRxiv, Semantic Scholar, Crossref, OpenAlex and 15+ other sources.

    2.8k GitHub stars~794 tokensUpdated 9 days ago
    Research & ScienceAuto-check: notes
  • Academic Search and Citation Router

    Yuan1z0825/nature-skills

    Finds papers across literature sources, verifies and converts citations, builds MeSH strategies and audits independent citations of a paper.

    47k GitHub stars~884 tokensUpdated today
    Research & ScienceAuto-check passed
  • Nature Academic Search

    jing1312/nature-figure-skill

    Multi-source literature search, citation verification, MeSH search strategy, citation file management (.nbib/.ris/.bib conversion), and reference management (BibTeX, related articles, ID conversion)…

    171 GitHub stars~1.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check: notes

Questions about Rival Search MCP

What does Rival Search MCP do?

Deterministic deep research via RivalSearchMCP. An agent skill from damionrashford/RivalSearchMCP. Rival Search MCP is an agent skill from damionrashford/RivalSearchMCP. Deterministic deep research via RivalSearchMCP.

When should I use Rival Search MCP?

Rival Search MCP fits situations like: the user needs web research; competitive analysis; content discovery; academic paper search.

How do I install Rival Search MCP in Claude Code?

Run `npx skills add damionrashford/RivalSearchMCP --skill rival-search-mcp -a claude-code`. Or copy the skill folder (skills/rival-search-mcp in damionrashford/RivalSearchMCP) into .claude/skills/rival-search-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Rival Search MCP in Codex?

Run `npx skills add damionrashford/RivalSearchMCP --skill rival-search-mcp -a codex`. Or copy the skill folder (skills/rival-search-mcp in damionrashford/RivalSearchMCP) into .agents/skills/rival-search-mcp in your project. Codex loads it when a task matches its description.

Can I use Rival Search MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add damionrashford/RivalSearchMCP --skill rival-search-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rival-search-mcp, .gemini/skills/rival-search-mcp, .github/skills/rival-search-mcp and .opencode/skills/rival-search-mcp in your project.

What does Rival Search MCP need to run?

Going by SKILL.md and its folder, Rival Search MCP needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Rival Search MCP access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Rival Search MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Rival Search MCP use?

Rival Search MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Rival Search MCP use?

About 796 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Rival Search MCP?

Skills that share tags, products or a category with Rival Search MCP: Local Search Fallback (taxueseek/argo, 188 stars), Paper Search (openags/paper-search-mcp, 2.8k stars), Nature Academic Search (wp-a/nature-academic-search, 304 stars) and Paper Search (openags/paper-search-mcp, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Rival Search MCP?

damionrashford (a GitHub user) maintains it in damionrashford/RivalSearchMCP, which has 132 GitHub stars. The repository was last updated on October 10, 2026.

Source: damionrashford/RivalSearchMCP on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.