Skip to main content
Glama
research-dispatcher-mcp

research-dispatcher-mcp

by 0x67108864

research-dispatcher-mcp

A Model Context Protocol (MCP) server that lets any MCP-capable AI agent run one research query across multiple public sources (Hacker News, Reddit, GitHub, Brave Web Search) in parallel, with source-specific query tuning baked in.

PyPI License: MIT

What it does

Exposes 5 MCP tools:

Tool

Source

Auth

research_hn

Hacker News (Algolia)

none

research_reddit

Reddit site-wide search

none (User-Agent only)

research_github

GitHub repositories

optional GITHUB_TOKEN for higher rate limit

research_brave

Brave Web Search

requires BRAVE_API_KEY

research_all

All of the above in parallel

per-source rules apply

Each tool returns JSON: a list of normalized hits with title, url, score/stars, created_at, and source-specific metadata. research_all aggregates into {source: {status, count, items}}.

Related MCP server: Web Research MCP

Why

AI agents that handle "what's the latest on X" tasks need to consult multiple sources but each has its own API, rate limit, and pitfalls. This server encodes those once so the agent calls one tool and gets normalized results.

Install

Requires Python 3.10+.

pip install canola-research-dispatcher-mcp

Configure your agent

Claude Code

Add to your ~/.claude/mcp.json:

{
  "mcpServers": {
    "research-dispatcher": {
      "command": "research-dispatcher-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_... (optional)",
        "BRAVE_API_KEY": "... (optional)"
      }
    }
  }
}

Restart Claude Code and the 5 research_* tools become available.

Codex CLI / Cursor / other MCP runtimes

Each runtime has its own MCP server registration. The command is always research-dispatcher-mcp.

Quickstart

"What's the latest on MCP server marketplaces?"
→ agent calls research_all(query="MCP server marketplace", limit=10, since_days=30)
→ HN + Reddit + GitHub returned in parallel, agent synthesizes

Environment variables

Variable

Default

Purpose

GITHUB_TOKEN

unset

Raises GitHub rate limit from 60/hr to 5000/hr

BRAVE_API_KEY

unset

Required to enable research_brave; without it the tool returns a "skipped" notice

Limitations

  • No paywall / logged-in content (X/Twitter, LinkedIn, private subreddits).

  • Reddit site-wide search has noticeably weaker recall than subreddit-specific browsing.

  • Brave's free tier is 2000 calls/month; this server does not currently track quota.

  • Source list is fixed in v0.1; add new sources in src/research_dispatcher_mcp/sources.py.

Development

git clone https://github.com/0x67108864/research-dispatcher-mcp.git
cd research-dispatcher-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.

Author

canola_oil — https://0x67108864.github.io/

Available Tools

5 tools
research_allA

Fan out the same query to multiple sources in parallel and return aggregated results grouped by source. Default sources: hn, reddit, github (and brave if API key set).

Inputs: query (required), limit, since_days, sources.

research_braveA

General web search via Brave Search API. Requires BRAVE_API_KEY env var. Best for fresh general-web content; complements HN/Reddit/GitHub when topic is non-tech.

Inputs: query (required), limit, since_days.

research_githubA

Search GitHub repositories filtered by recent push activity. Best for OSS trends and active projects. Honors GITHUB_TOKEN env var (60/hr anon vs 5000/hr authenticated).

Inputs: query (required), limit, since_days.

research_hnA

Search Hacker News (via Algolia) for stories matching a query within a recent time window. No authentication required. Best for tech news, Show HN launches, deep technical discussion.

Inputs: query (required), limit, since_days.

research_redditA

Site-wide search across Reddit. Best for community sentiment, niche subreddit signal. Returns posts with subreddit, score, and permalink.

Inputs: query (required), limit, since_days.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a unique source (all, brave, github, hn, reddit) with clear descriptions that differentiate their use cases. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent 'research_<source>' pattern using snake_case, making it predictable for agents.

    Tool Count5/5

    5 tools is an ideal count for a research dispatcher, covering the key sources without being excessive or insufficient.

    Completeness4/5

    The set covers major tech and community sources (HN, Reddit, GitHub) plus general web via Brave. Minor gaps like news or Twitter, but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to perform unified web searches, GitHub, and GitLab searches with caching, reranking, and fallback across multiple providers.
      4
      86 npm
      20
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search and fetch high-quality information from multiple sources, including general web APIs, Wikipedia, arXiv, Hacker News, Stack Exchange, and Crossref, with optional pro-mode deep research and clean markdown page extraction.
      10
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to run local multi-engine web searches, fetch pages through anti-bot fallback chains, and query site-specific sources such as GitHub, npm, PyPI, Docker Hub, and Twitter/X for structured results.
      3
      MIT