Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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 |
|---|---|---|
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}}.
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 |
|---|---|---|
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]"
pytestRelated
- The original SKILL.md format version:
canola_oil/skills/research-dispatcher— instruction-based, drop-in folder for agentskills.io runtimes - Agent Skills standard: agentskills.io
- Model Context Protocol: modelcontextprotocol.io
License
MIT — see LICENSE.
Author
canola_oil — https://0x67108864.github.io/