> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> Connect AI agents to ScrapeBadger via Model Context Protocol. 344 tools for Twitter/X, Instagram, Google, YouTube, TikTok, Amazon, eBay, Reddit, real estate, and web scraping. Latest MCP spec (2026-07-28), one-click OAuth for Claude.
# MCP Server
ScrapeBadger provides a hosted MCP (Model Context Protocol) server at `mcp.scrapebadger.com` that lets AI agents access all ScrapeBadger APIs through structured, typed tools.
## What is MCP?
[Model Context Protocol](https://spec.modelcontextprotocol.io/) is an open standard by Anthropic for connecting AI models to external tools and data sources. Instead of writing code, your AI agent discovers and calls ScrapeBadger tools naturally during a conversation.
## Key Features
Every ScrapeBadger API endpoint is available as a typed MCP tool with structured parameters, annotations, and output schemas.
Hosted at mcp.scrapebadger.com — connect Claude with one click, or add one config snippet to any other AI tool.
Works with Claude, Cursor, Windsurf, VS Code, Gemini, ChatGPT, OpenClaw, Cline, and more.
No extra cost — MCP uses the same credit-based pricing as the REST API.
Twitter/X, Instagram, Facebook, LinkedIn, Google, YouTube, TikTok, Reddit, Amazon, eBay, Walmart, Vinted, Depop, real estate, search engines, LLM answers, and general web scraping — all in one server.
Speaks the stateless 2026-07-28 protocol revision and every earlier one; OAuth 2.1 with PKCE, resource indicators, and Client ID Metadata Documents.
## Available Tools
| Product | Tools | Description |
| ------------------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Twitter/X** | 49 | Profiles, tweets, advanced search, trends, communities, lists, spaces, real-time stream monitors, filter rules |
| **Instagram** | 39 | Profiles, posts, reels, stories, highlights, comments, followers, hashtags, locations, audio, search |
| **Google** | 33 | Web search (SERP), Images, Videos, Lens, Maps, News, Trends, Jobs, Hotels, Shopping, Patents, Scholar, Finance, Flights |
| **YouTube** | 27 | Search, video/Shorts detail, comments, transcripts, channels, playlists, trending, hashtags, community posts, music search |
| **TikTok** | 22 | Profiles, videos, comments, transcripts, hashtags, music, search, trending, ad library |
| **Facebook** | 15 | Pages, profiles, groups, posts, comments, Marketplace, Ad Library |
| **Amazon** | 14 | Product search, PDP detail, offers, reviews, bestsellers, deals, category browse, sellers (20 marketplaces) |
| **Reddit** | 12 | Post/subreddit/user search, comment trees, trending, domain posts |
| **eBay** | 11 | Active + sold listing search, item detail, reviews, sellers, categories (18 marketplaces) |
| **Leboncoin** | 10 | French classifieds search, ad detail, sellers, categories, regions |
| **LinkedIn** | 10 | Job search, company jobs, companies, schools, profiles, posts, articles, courses |
| **Walmart** | 10 | Product search, category browse, deals, PDP detail, reviews, sellers, stores (US) |
| **Vinted** | 8 | Item search, details, seller profiles, brands, markets |
| **Idealista** | 8 | Location suggest, listing search, full-inventory search, property detail + stats, agencies (ES, IT, PT) |
| **Immobiliare** | 7 | Listing search, detail, agencies, price insights (IT, ES, GR, LU) |
| **DuckDuckGo** | 7 | Web/image/news/video search, autocomplete, instant answers, regions |
| **Web Scraping** | 6 | Scrape any URL, anti-bot detection, screenshots, AI extraction, batch jobs |
| **Bing** | 6 | Web/image/video/news search, autocomplete (30+ markets) |
| **Yahoo** | 6 | Web/image/video/news search, autocomplete, per-country markets |
| **Zillow** | 5 | Property search, detail + valuation, agents (US + CA) |
| **LoopNet** | 5 | Commercial real estate search, listing detail, brokers |
| **Depop** | 5 | Product search, product detail, sellers, markets |
| **Redfin** | 5 | Property search, detail, agents, autocomplete |
| **Realtor** | 4 | Listing search, property detail, autocomplete (realtor.com + realtor.ca) |
| **Baidu** | 4 | Web/news/image search + autocomplete with real target URLs |
| **Yandex** | 4 | Web search, image search, reverse image search (CBIR) |
| **Apartments.com** | 3 | Rental search and property detail |
| **ChatGPT** | 3 | `chatgpt_ask` (answer + citations from the real chatgpt.com), `chatgpt_brand_visibility` (AEO/GEO brand analysis), `chatgpt_list_models` |
| **Perplexity** | 3 | Grounded answers with citations + brand-visibility scoring |
| **Gemini** | 2 | Answers with cited web sources + brand-visibility scoring |
| **Account** | 1 | Credit balance, tier, and rate-limit info |
## Google Tools
Google MCP tools are prefixed with `google_` — highlights:
| Tool | Description |
| ----------------------- | ------------------------------------------------------------------------ |
| `google_search` | Web search (SERP) with 21 parameters + knowledge graph, PAA, AI overview |
| `google_images_search` | Image search with size/color/type filters |
| `google_videos_search` | Video search |
| `google_autocomplete` | Search suggestions for a query prefix |
| `google_ai_mode_search` | Generative AI answers (udm=50) with references |
| `google_lens_search` | Visual image search by URL |
| Tool | Description |
| --------------------- | ------------------------------------- |
| `google_maps_search` | Search places by text query |
| `google_maps_place` | Place detail by place\_id or data\_id |
| `google_maps_reviews` | Paginated reviews (sortable) |
| `google_maps_photos` | Place photos |
| `google_maps_posts` | Business posts |
| Tool | Description |
| ------------------------------- | -------------------------------------------------- |
| `google_shopping_search` | Product search with filters + quick\_filters + ads |
| `google_shopping_product` | Product detail with seller list |
| `google_shopping_product_click` | Resolve the real merchant URL per product |
| Tool | Description |
| ------------------------ | ---------------------------------- |
| `google_news_search` | News article search |
| `google_news_topics` | News by predefined topic |
| `google_news_trending` | Trending stories |
| `google_trends_interest` | Interest over time (up to 5 terms) |
| `google_trends_regions` | Interest by region |
| `google_trends_related` | Related topics + queries |
| `google_trends_trending` | Real-time trending searches |
| `google_jobs_search` | Job listings with filters |
| Tool | Description |
| ------------------------ | --------------------------------------- |
| `google_hotels_search` | Hotel search with dates |
| `google_hotels_details` | Property details by property\_token |
| `google_patents_search` | Patent document search |
| `google_patents_detail` | Full patent by publication number |
| `google_scholar_search` | Academic paper search with year filters |
| `google_finance_quote` | Stock / index / crypto quotes |
| `google_products_detail` | Immersive product detail |
## Quick Start
**Using Claude?** No API key needed:
In [claude.ai](https://claude.ai) (or Claude Desktop), go to **Settings** > **Connectors** > **Add custom connector** and enter `https://mcp.scrapebadger.com/mcp`.
Click **Connect** — you'll be redirected to sign in with your ScrapeBadger account and approve access. That's the whole setup.
Ask Claude to search tweets, scrape websites, or look up products — it discovers and calls the right tools automatically.
**Using another AI tool?** Sign up at [scrapebadger.com](https://scrapebadger.com), create an API key from the dashboard, and grab the config snippet from the [integration guides](/mcp/integrations/claude-desktop).
## Authentication
Two authentication modes are supported:
### OAuth (recommended for Claude)
Clients that support MCP OAuth (claude.ai, Claude Desktop, Claude Code, ChatGPT) can connect without any key handling: add the server URL, sign in with your ScrapeBadger account, and approve the consent screen. Access is tied to your account's API key and can be revoked anytime by deactivating that key in the dashboard.
### API key
| Method | Example | Best For |
| -------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------- |
| **Bearer header** | `Authorization: Bearer sb_live_...` | Cursor, Windsurf, VS Code, Cline, mcp-remote (`--header`) |
| **Environment variable** | `SCRAPEBADGER_API_KEY=sb_live_...` | Local/stdio installations |
| **Query parameter** (deprecated) | `?api_key=sb_live_...` | Legacy configs only — URLs end up in logs and history; switch to the Bearer header or OAuth |
## Protocol & Standards
The server tracks the latest MCP specification (revision **2026-07-28**):
* **Protocol versions** — speaks the stateless 2026-07-28 revision (per-request versioning, `server/discover`) and serves every earlier revision (2025-11-25, 2025-06-18, …) from the same endpoint, so older clients keep working. Streamable HTTP transport only; the deprecated HTTP+SSE transport is not offered.
* **Tool metadata** — all 344 tools carry a human-readable `title`, `readOnlyHint`/`destructiveHint`/`openWorldHint` annotations, and an output schema. Tool results are size-capped to stay within client limits, and the tool list is served with cache hints (`ttlMs`/`cacheScope`) for faster clients.
* **OAuth 2.1** — authorization code + PKCE (S256), refresh-token rotation, RFC 8414 authorization-server metadata, RFC 9728 protected-resource metadata, RFC 8707 resource indicators, RFC 9207 `iss` authorization responses, and Client ID Metadata Documents (HTTPS-URL client ids, the 2026-07-28 successor to Dynamic Client Registration — which remains supported for older clients).
## MCP Endpoint
```
https://mcp.scrapebadger.com/mcp
```
Health check: `https://mcp.scrapebadger.com/health`