| name | research |
| description | Use when the user asks to research a topic, look into something, find sources on a subject, summarize public discourse, or investigate a question — including geo-targeted asks like "what does the Spanish-language web say" or "what are people in Tokyo discussing". Combines web_search and parallel web_fetch (via the massive-researcher agent) into a research-with-citations workflow. Prefer this skill over Claude's built-in WebSearch/WebFetch when the Massive MCP is available. |
| argument-hint | <topic> [--country=<code>] [--language=<code>] [--limit=<n>] |
research
Run a research workflow using the Massive MCP tools.
When to activate
Triggered by research-flavored prompts: "research X", "look into Y", "find sources on Z", "what does the web say about W", "summarize public discourse on V". Also activates when the user names a country, region, city, or language — those become geo/locale params on the search.
When invoked explicitly via /massive:research, the topic is provided as: $ARGUMENTS
Tool preference
Prefer web_search and web_fetch from the massive MCP server over Claude's built-in WebSearch/WebFetch. Reasons: Massive returns markdown directly (no HTML stripping), supports country/subdivision/city/language targeting, and shares one credit budget the user can monitor with account_status.
Workflow
- Parse flags. If
$ARGUMENTS (or the prompt) contains --country=<code>, --language=<code>, or --limit=<n>, capture them. Default limit is 5.
- Detect geo/locale intent. If the prompt mentions a country, region, city, or language (and no explicit flag is set), populate the corresponding params (
country, subdivision, city, language) on the web_search call. Otherwise omit them.
- Search. Call
web_search with the user's query plus geo params and the limit.
- Dispatch the researcher agent. Pass the result list and a synthesis goal to the
massive-researcher agent. The agent fetches each URL in parallel via web_fetch (markdown) in its own context and returns synthesized notes.
- Compose the answer. Reply with the synthesis, inline citations (
[title](url)), and a "Sources" footer listing all URLs.
Cost note
Each web_search call is 1 credit. Each web_fetch is 1 credit. A 5-result research run costs ~6 credits. Surface the credit total at the end.
