@joinmassive/mcp-server
OfficialAllows searching Google and retrieving structured results including organic listings, AI overview, and people also ask.
Allows querying the Perplexity AI chatbot for answers with sources.
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., "@@joinmassive/mcp-server Fetch https://news.ycombinator.com and summarize the top stories."
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.
@joinmassive/mcp-server
Official MCP server for the Massive Web Render API. Give your AI agents real-time web access — fetch any URL, search Google, query AI chatbots — with JS rendering, captcha solving, and 195+ country geo-targeting handled automatically.
Quickstart (Claude Desktop)
Option A — One-click install (.mcpb)
Download the latest
massive-mcp-X.Y.Z.mcpbfrom GitHub Releases.Open the file with Claude Desktop (or drag-drop into Settings → Extensions).
Paste your Massive API token when prompted. Token is stored in your OS keychain.
Option B — npx + config snippet
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"massive": {
"command": "npx",
"args": ["-y", "@joinmassive/mcp-server"],
"env": { "MASSIVE_TOKEN": "your-token-here" }
}
}
}Restart Claude Desktop.
Related MCP server: Spider MCP Server
Quickstart (Claude Code)
One command, works across all your projects:
claude mcp add massive --scope user -e MASSIVE_TOKEN=your-token-here -- npx -y @joinmassive/mcp-serverThen /mcp in any Claude Code session to confirm it's connected. Drop --scope user to scope it to the current project only.
Other MCP clients
The same JSON snippet works for any MCP-compatible client. Drop it into the client's config file:
Client | Config path |
Cursor |
|
Continue |
|
Cody |
|
Windsurf |
|
VS Code (MCP) |
|
If npx isn't on the client's PATH, swap to a direct binary path: "command": "node", "args": ["/absolute/path/to/dist/index.js"].
Getting an API token
Sign in at dashboard.joinmassive.com → Developer → API Keys.
Tools
web_fetch
Fetch any URL. Returns Markdown by default (best for LLMs).
Arg | Type | Default | Notes |
| string (required) | — | |
|
|
| |
| string (ISO 3166-1 alpha-2) | — | |
| string | — | |
| string | — | ISO 3166-2 (e.g. |
| string | — | Device emulation name |
| integer (0–365) | — | Days the cached result is reused. |
|
|
| Anti-bot evasion strength. Multipliers: |
Example prompt: "Use the Massive MCP server to fetch https://news.ycombinator.com and summarise the top stories."
web_search
Google search results, parsed into structured JSON.
Arg | Type | Default |
| string | — |
| string (ISO) | — |
| string | — |
| string | — |
| number | 10 |
| integer (0–365) | — |
| string | — |
| string | — |
Returns: { organic, ai_overview, people_also_ask, query }.
Example shape:
{
"query": "best espresso machines 2026",
"organic": [
{ "title": "...", "url": "https://...", "snippet": "..." }
],
"ai_overview": { "answer": "...", "sources": [{ "domain": "wirecutter.com", "url": "https://..." }] },
"people_also_ask": [
{ "question": "What is the best espresso machine for beginners?", "answer": "" }
]
}Example prompt: "Use web_search to find recent reviews of espresso machines and return the top 3 organic results plus the AI overview."
ai_chat_completion
Chatbot answer with sources.
Arg | Type | Default |
| string | — |
|
|
|
| string (ISO) | — |
| string | — |
| string | — |
| integer (0–365) | — |
| string | — |
| string | — |
| string | — |
Returns: { completion, sources, model, subqueries? }.
account_status
No args. Returns { credits_remaining }. Useful to warn the user before they run out of credits. Free — does not consume credits.
Pricing & cost control
Credit costs (live reference: https://joinmassive.com/pricing):
Endpoint | Base cost | Notes |
| 1 credit | Multipliers — |
| 1 credit | No multipliers |
| 1 credit | No multipliers |
| Free | — |
Worked example: web_fetch with difficulty=medium costs 1 × 2 = 2 credits.
Tips for keeping costs down
Cache:
expiration(days) reuses recent results. Default1. Setexpiration=0only when freshness matters (prices, scores, weather).Difficulty: start with default
low. Bump tomedium/highonly if the low attempt fails.Check first: call
account_status(free) before launching a batch.
Resources
This server exposes three read-only reference documents at docs:// URIs. They show up in your MCP client as attachable references:
URI | Contents |
| Credit costs and multipliers (same as the table above, inline in your client) |
| 190+ countries, subdivision/city format, examples |
| What's new in each release |
In Claude Desktop: open the Connectors panel and pick the resource from this server. In Claude Code: type @ and search by name. The model does not auto-read these — they're for you to browse.
Troubleshooting
"MASSIVE_TOKEN env var is not set"
Confirm the env block in your Claude Desktop config has the token. Restart Claude Desktop.
"Massive endpoint is autoscaling, please retry" A 503 from upstream. The server already retried once; wait ~10s and try again.
"403 Forbidden — the request was rejected (likely captcha or invalid token)" Either the target site rejected our captcha solver, or the token is invalid. Re-check the token at the dashboard.
No tools appear in Claude Desktop
Settings → Developer → check the MCP server logs. The most common cause is command: "npx" not being on Claude Desktop's PATH. Run which npx in Terminal — if it's under Homebrew (/opt/homebrew/bin), Claude Desktop's PATH won't include it. As a workaround, use a direct path: "command": "node", "args": ["/absolute/path/to/dist/index.js"]. Or install the .mcpb bundle (Option A above), which sidesteps PATH issues entirely.
Contributing
Issues and PRs welcome at github.com/joinmassive/mcp-server.
License
MIT. See LICENSE.
Available Tools
4 toolsaccount_statusAccount statusA
Returns the user's remaining credit balance. Free; does not consume credits.
Inputs: no named parameters.
ai_chat_completionAI chat completionA
Get a chatbot answer (ChatGPT, Gemini, Perplexity, or Copilot) with structured sources.
Cost: 1 credit base. No multipliers. Use expiration=0 for fresh answers; default expiration=1 (day) reuses cached responses. Localize with country, subdivision, city, language, display, device.
Inputs: prompt (required), model, country, city, +5 more.
web_fetchWeb fetchA
Fetch any URL through Massive. Returns Markdown by default (best for LLM consumption); also supports rendered HTML and raw HTML. Handles JS rendering, captcha solving, and 195+ country geo-targeting.
Cost: 1 credit base. Multipliers stack:
difficulty=medium → 2×
difficulty=high → premium (higher multiplier; use only if low fails)
Geo-targeting (country/city) does not currently change cost.
Use expiration=0 for always-live data (prices, scores). Default expiration=1 (day) reuses cached results. Live pricing: https://joinmassive.com/pricing
Inputs: url (required), format, country, city, +4 more.
web_searchWeb searchA
Google search results parsed into structured JSON. Returns organic results, AI overview (if present), and 'people also ask' questions.
Cost: 1 credit base. No multipliers. Use expiration=0 for always-live results; default expiration=1 (day) reuses cached SERPs. Localize with country, subdivision, city, language, display.
Inputs: query (required), country, city, subdivision, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: account_status for credit balance, ai_chat_completion for chatbot responses, web_fetch for fetching URLs, and web_search for search results. No overlap.
All tools use snake_case and follow a verb_noun pattern: account_status, ai_chat_completion, web_fetch, web_search. Naming is uniform and predictable.
With 4 tools, the server is well-scoped for its purpose of providing access to various Massive services. Not too few, not too many.
The tool set covers the core functionalities: account info, AI chat, web fetch, and search. A minor gap is the lack of a tool for user profile or usage history beyond credits, but the current set is sufficient for typical use.
Maintenance
Related MCP Connectors
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Web scraping, search, crawling, structured extraction and research for AI agents.
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
Unblocking and fresh web data for agents: URL to Markdown, YouTube, Maps, Amazon, jobs. Pay per call
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to access real-time web data through search, markdown scraping, and browser automation while bypassing anti-bot protections. It provides tools for web research, e-commerce monitoring, and data extraction from across the globe.45MIT
- AlicenseAqualityCmaintenanceEnables AI agents to crawl, scrape, search, and automate browsers with anti-bot bypass, providing fast web access via 22 tools.22316 npm3MIT
- AlicenseBqualityDmaintenanceEnables AI agents to browse and extract data from any public website via Bright Data's cloud infrastructure, handling proxy rotation, CAPTCHA solving, and JavaScript rendering.57MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to search the web, read and extract content from webpages, fetch JSON from REST APIs, and collect links while bypassing anti-bot protections.-