Google Maps data for agents

Official6 tools

by google-maps

4 Google Maps endpoints. Pay per call in USDC via x402.

The sh.fetcher.google-maps/mcp server provides access to 4 Google Maps endpoints. It is described as operating on a pay-per-call basis, with payments handled in USDC via x402. The server is intended to fetch data from Google Maps through these configured endpoint routes.

🛠️ Key Features

4 Google Maps endpoints
Pay per call billing
Payments in USDC via x402

🚀 Use Cases

Fetching from Google Maps using the available 4 endpoints
Building applications that require repeated Google Maps calls with per-request costs

⚡ Developer Benefits

Clear endpoint count: 4 Google Maps endpoints
Predictable cost model: pay per call
Payment integration details: USDC via x402

⚠️ Limitations

Limited to the provided set of 4 Google Maps endpoints

Captured live from the server via tools/list.

search_endpoints

Free. Search fetcher.sh's Google Maps endpoints by keyword. Returns paths, descriptions and per-call prices. Start here.

Parameters1

query

string

optional

Keywords, e.g. 'twitter followers' or 'reviews'

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. 'twitter followers' or 'reviews'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_endpoint

Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.

Parameters1

path

string

required

Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch_data

Paid. Fetch live data from any Google Maps endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Polygon, Arbitrum, Monad or Solana: pay with x402, or send an Authorization: Bearer bby_live_... header to spend prepaid credits. Call describe_endpoint first if unsure about parameters.

Parameters2

path	string	required	Endpoint path from search_endpoints, e.g. /api/google-maps/place/search
params	object	optional	All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path from search_endpoints, e.g. /api/google-maps/place/search"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

topup_credits

Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.

Parameters2

amount	number	required	Amount to add, in USD. Minimum 1.
rotate	boolean	optional	Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Amount to add, in USD. Minimum 1."
    },
    "rotate": {
      "type": "boolean",
      "description": "Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

google_maps_place_search

Paid ($0.005). Place search — Google Maps. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters7

query	string	required	Required.
languageCode	string	optional	Optional.
countryCode	string	optional	Optional.
latitude	string	optional	Optional.
longitude	string	optional	Optional.
offset	string	optional	Optional.
zoom	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Required."
    },
    "languageCode": {
      "type": "string",
      "description": "Optional."
    },
    "countryCode": {
      "type": "string",
      "description": "Optional."
    },
    "latitude": {
      "type": "string",
      "description": "Optional."
    },
    "longitude": {
      "type": "string",
      "description": "Optional."
    },
    "offset": {
      "type": "string",
      "description": "Optional."
    },
    "zoom": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (6)

search_endpointsdescribe_endpointfetch_datacheck_balancetopup_creditsgoogle_maps_place_search

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://google-maps.fetcher.sh/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://google-maps.fetcher.sh/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Google Maps data for agents - agentage MCP Catalog