Back to Browse

Research Scope MCP Server

Developer ToolsUse Caution2.4MCP RegistryLocal
Free

Server data from the Official MCP Registry

Plan research, score sources for freshness/COI, and enforce claim-level citations in reports.

About

Plan research, score sources for freshness/COI, and enforce claim-level citations in reports.

Security Report

2.4
Use Caution2.4Critical Risk

The server is a legitimate research workflow tool with no exfiltration, backdoors, or hardcoded secrets, and its dependencies are standard. However, the Streamable HTTP mode has no authentication at all despite the README and code comments claiming 401 discovery behavior, and it binds to all interfaces. Combined with fetch_and_score fetching arbitrary URLs and returning their content, and check_report reading arbitrary file paths, these issues drive the score below 7.0. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 4 high severity).

7 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-axelvernebooks-research-scope-mcp": {
      "args": [
        "-y",
        "research-scope-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

research-scope-mcp

Turn a scattered source set into a decision-ready, traceable report.

research-scope-mcp is an MCP server that runs a research-to-report workflow any MCP client can drive end to end:

  1. plan_research(scope) — turns a research scope into a source-target plan with kill criteria ("fewer than 1 primary + 2 independent secondaries → stop and report insufficient sources, don't proceed on thin evidence").
  2. fetch_and_score(source_url) — crawls one source and returns an explainable 0–100 quality score: primary-source detection, publication freshness, paywall and conflict-of-interest flags — every dimension returned with the evidence.
  3. build_report(topic, sources) — assembles a citation-registry report shell (claims section + numbered registry + scoring appendix) for the scored sources.
  4. check_report(report) — verifies every substantive claim cites ≥1 scored source. Orphan claims come back as an error list, not a pass.

The problem it solves: agent-written reports that sound confident but can't show where any sentence came from. This server makes scoring and citation coverage mechanically enforced, so the report is auditable by a human in 90 seconds.

Install

npm install -g research-scope-mcp   # once published; local: npm ci && npm run build

Run over stdio (most clients):

npx research-scope-mcp

Or over Streamable HTTP (remote deployments):

npx research-scope-mcp --http --port 3001
# unauthenticated requests get 401 + WWW-Authenticate discovery, never a bare 403

Client config

Drop-in config snippets for Claude Code, Cursor, and a Cline-friendly llms-install.md.

Docker

docker build -t research-scope-mcp -f docker/Dockerfile .
docker run --rm -i -p 3001:3001 research-scope-mcp --http --port 3001

Tools

ToolInputOutput
plan_researchscope, optional domain_hintssource-target plan with kill criteria
fetch_and_scoresource_url0–100 score + flags (primary, freshness, paywall, COI), registered for reporting
build_reporttopic, sources[] (must already be scored)report shell saved under data/reports/, [Sn] citation numbering
check_reportreport_id or report_pathpass/fail + orphan-claim error list

Example walkthrough

See docs/runs/ for two worked runs with inputs and outputs, and docs/notes/ for what to do when something times out or 401s.

Scoring rubric

DimensionMaxNotes
Availability & substance20extractable text length
Primary-source status32host class (gov/edu/filings) or self-published primary (press/announcement paths)
Freshness24≤30d full marks, decays to 2 at >5y, 0 if undetectable
Access12paywall/registration walls lose marks
Independence12sponsored/affiliate/partnership markers

score ≥ 80 → A, ≥ 65 → B, ≥ 45 → C, else D. The rubric is inside src/scoring/score.ts and returns its evidence, so a score is auditable, not a vibe.

License

MIT. See SECURITY.md for reporting security issues.

Paid kit

This server is the free, tested core of the Research-to-Report MCP Kit (field guide, worked example packs, setup support). Available at the kit store — link in CHANGELOG.md updates.

Reviews

No reviews yet

Be the first to review this server!