mcp-server
MCP server for Google Maps places and reviews: give Claude, Cursor and other AI assistants place search, details and all reviews via ScrapeMapsAPI.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/scrapemapsapi--mcp-server)HTML
<a href="/listings/scrapemapsapi--mcp-server"><img src="/api/listings/scrapemapsapi--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Get an API key
Create one at [scrapemapsapi.com](https://scrapemapsapi.com/dashboard/api-keys).
2. Configure your client
Claude Desktop (`claude_desktop_config.json`), Cursor (`.cursor/mcp.json`), Cline and most other clients:
{
"mcpServers": {
"scrapemapsapi": {
"command": "uvx",
"args": ["scrapemapsapi-mcp"],
"env": {
"SCRAPEMAPSAPI_API_KEY": "your_api_key"
}
}
}
}Claude Code:
claude mcp add scrapemapsapi -e SCRAPEMAPSAPI_API_KEY=your_api_key -- uvx scrapemapsapi-mcp
3. Use it
- "Find the five best-rated ramen places in Milan and check what recent reviews say" - "Summarize the reviews of https://maps.app.goo.gl/..." - "Show me the one-star reviews of Pizzeria Da Michele in Naples, written in Italian" - "Is the Louvre open on Monday?"
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 121 lines
- # ScrapeMapsAPI MCP Server
- <!-- mcp-name: com.scrapemapsapi/scrapemapsapi -->
- An [MCP](https://modelcontextprotocol.io) server that gives AI assistants (Claude Desktop, Claude Code, Cursor, Cline, ...) access to Google Maps places, place details and **all** the reviews of a place, via the [ScrapeMapsAPI](https://scrapemapsapi.com) API.
- ## No install: connect from Claude or ChatGPT
- ScrapeMapsAPI also runs as a **remote MCP server** with OAuth sign-in, so you can use the same tools from
- Claude (claude.ai, Desktop, mobile), ChatGPT or any client that supports remote servers, without an API key or
- anything to install:
- ```
- https://api.scrapemapsapi.com/mcp
- ```
- - **Claude**: Customize → Connectors → + Add → Add custom connector, paste the URL, then sign in with your
- ScrapeMapsAPI account and allow access.
- - **ChatGPT**: chatgpt.com/plugins → + → Add custom MCP server, paste the URL as Server URL, OAuth authentication.
- - **Claude Code**: `claude mcp add --transport http scrapemapsapi https://api.scrapemapsapi.com/mcp`, then `/mcp`
- to sign in.
- Calls use your account's credits exactly like the API; see or disconnect connected apps in Dashboard → Connected
- apps. Step-by-step guide: https://scrapemapsapi.com/docs/mcp. The package below is the **local** server (stdio,
- API key), for developers who prefer to run it themselves; both offer the same tools, prompts and resources.
- ## Features
- **4 tools**: `search_places`, `get_place`, `get_reviews`, `resolve_place`. Results are compact text built for LLMs: the useful fields only, long texts capped, and the identifiers and cursors needed for the next call.
- **4 documentation resources**: API reference, quickstart, pricing, workflow examples.
- **3 prompts**: summarize the reviews of a place, compare places, find the best places of a kind in an area.
- ## Quick start
- ### 1. Get an API key
- Create one at [scrapemapsapi.com](https://scrapemapsapi.com/dashboard/api-keys).
- ### 2. Configure your client
- Claude Desktop (`claude_desktop_config.json`), Cursor (`.cursor/mcp.json`), Cline and most other clients:
- ```json
- {
- "mcpServers": {
- "scrapemapsapi": {
- "command": "uvx",
- "args": ["scrapemapsapi-mcp"],
- "env": {
- "SCRAPEMAPSAPI_API_KEY": "your_api_key"
- }
- }
- }
- }
- ```
- Claude Code:
- ```bash
- claude mcp add scrapemapsapi -e SCRAPEMAPSAPI_API_KEY=your_api_key -- uvx scrapemapsapi-mcp
- ```
- ### 3. Use it
- - "Find the five best-rated ramen places in Milan and check what recent reviews say"
- - "Summarize the reviews of https://maps.app.goo.gl/..."
- - "Show me the one-star reviews of Pizzeria Da Michele in Naples, written in Italian"
- - "Is the Louvre open on Monday?"
- ## Tools
- | Tool | What it does | Credits |
- |------|-------------|---------|
- | `search_places` | Text search, optionally near `lat`/`lng` within `radius_km`; `limit` 1-20 (default 10), `cursor` for more | 1 per place |
- | `get_place` | Details: address, phone, website, opening hours, description, features, photos, IDs | 2 |
- | `get_reviews` | One page of reviews; `sort` relevant/newest/highest/lowest, `language` (translation target), `original_language` filter, `limit` 1-50, `cursor` | 1 per 2 reviews |
- | `resolve_place` | Google Maps URL (short links too), place ID, CID or feature ID into every identifier | 0-1 |
- Places are identified by a place ID (`ChIJ...`), a CID (digits) or a feature ID (`0x...:0x...`). Review texts are capped at 600 characters and owner replies at 200. API errors are returned as tool errors with a readable message and what to do next (e.g. top up credits, use `resolve_place`).
- ## Installation alternatives
- ```bash
- # pip
- pip install scrapemapsapi-mcp
- SCRAPEMAPSAPI_API_KEY=... scrapemapsapi-mcp
- # npx (wraps uvx, or python3 -m as a fallback)
- SCRAPEMAPSAPI_API_KEY=... npx -y scrapemapsapi-mcp
- # Docker
- docker build -t scrapemapsapi-mcp . && docker run -i --rm -e SCRAPEMAPSAPI_API_KEY=... scrapemapsapi-mcp
- ```
- ## Environment variables
- | Variable | Required | Description |
- |----------|----------|-------------|
- | `SCRAPEMAPSAPI_API_KEY` | Yes | Your API key |
- | `SCRAPEMAPSAPI_BASE_URL` | No | Override the API base URL (default `https://api.scrapemapsapi.com`), e.g. `http://localhost:8000` |
- ## Development
- ```bash
- cd sdks/mcp
- uv venv && uv pip install -e ".[dev]"
- .venv/bin/pytest
- .venv/bin/ruff check .
- ```
- Test with the MCP Inspector:
- ```bash
- SCRAPEMAPSAPI_API_KEY=... SCRAPEMAPSAPI_BASE_URL=http://localhost:8000 uv run mcp dev dev_server.py
- ```
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.