research-dispatcher-mcp
Allows searching Hacker News posts via the Algolia API, returning normalized results with title, URL, points, and creation date.
Integrates Brave Web Search to retrieve web search results, requiring a BRAVE_API_KEY. Returns normalized results with title, URL, and description.
Searches GitHub repositories for a given query, optionally using a GITHUB_TOKEN for higher rate limits. Returns results with title, URL, stars, and creation date.
Performs site-wide Reddit search without authentication (only User-Agent required), returning normalized results with title, URL, score, and creation date.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@research-dispatcher-mcp What are people saying about AI coding tools?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
What it does
Exposes 5 MCP tools:
Tool | Source | Auth |
| Hacker News (Algolia) | none |
| Reddit site-wide search | none (User-Agent only) |
| GitHub repositories | optional |
| Brave Web Search | requires |
| 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-mcpConfigure 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 synthesizesEnvironment variables
Variable | Default | Purpose |
| unset | Raises GitHub rate limit from 60/hr to 5000/hr |
| unset | Required to enable |
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]"
pytestRelated
The original SKILL.md format version:
canola_oil/skills/research-dispatcher— instruction-based, drop-in folder for agentskills.io runtimesAgent Skills standard: agentskills.io
Model Context Protocol: modelcontextprotocol.io
License
MIT — see LICENSE.
Author
canola_oil — https://0x67108864.github.io/
Available Tools
5 toolsresearch_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
Scored across 5 tools
Each tool targets a unique source (all, brave, github, hn, reddit) with clear descriptions that differentiate their use cases. No overlap or ambiguity.
All tools follow a consistent 'research_<source>' pattern using snake_case, making it predictable for agents.
5 tools is an ideal count for a research dispatcher, covering the key sources without being excessive or insufficient.
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
Related MCP Connectors
Give your agent live data from Twitter, Reddit, the web and GitHub. No API keys, no scraping stack.
Agent-native search engine with live web research optimized for AI agents.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Web data for agents: YouTube transcripts, screenshots, Google News, WHOIS, jobs, tech stack, more.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to perform unified web searches, GitHub, and GitLab searches with caching, reranking, and fallback across multiple providers.486 npm20MIT
- AlicenseAqualityBmaintenanceEnables 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.10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI to perform fast, multi-source web searches and research through tools for web, social, news, GitHub, and document analysis.MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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.3MIT