search-maps
Search Google Maps to find locations and businesses using queries, GPS coordinates, place IDs, or CIDs. Leverage Dumpling AI MCP Server for precise and customizable map-based data retrieval.
Instructions
Search Google Maps for locations and businesses.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cid | No | Google Maps CID | |
| gpsPositionZoom | No | GPS coordinates with zoom (e.g., 'lat,long,zoom') | |
| language | No | Language code (e.g., 'en') | |
| page | No | Page number | |
| placeId | No | Google Place ID | |
| query | Yes | Search query |
Implementation Reference
- src/index.ts:181-203 (handler)The handler function for the 'search-maps' MCP tool. It proxies the request to the Dumpling AI API endpoint /api/v1/search-maps, handles authentication with DUMPLING_API_KEY, and returns the API response as structured content.async ({ query, gpsPositionZoom, placeId, cid, language, page }) => { const apiKey = process.env.DUMPLING_API_KEY; if (!apiKey) throw new Error("DUMPLING_API_KEY not set"); const response = await fetch(`${NWS_API_BASE}/api/v1/search-maps`, { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}`, }, body: JSON.stringify({ query, gpsPositionZoom, placeId, cid, language, page, }), }); if (!response.ok) throw new Error(`Failed: ${response.status} ${await response.text()}`); const data = await response.json(); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; }
- src/index.ts:170-180 (schema)Zod input schema for the 'search-maps' tool, defining parameters like query, optional GPS position, Place ID, CID, language, and page.{ query: z.string().describe("Search query"), gpsPositionZoom: z .string() .optional() .describe("GPS coordinates with zoom (e.g., 'lat,long,zoom')"), placeId: z.string().optional().describe("Google Place ID"), cid: z.string().optional().describe("Google Maps CID"), language: z.string().optional().describe("Language code (e.g., 'en')"), page: z.number().optional().describe("Page number"), },
- src/index.ts:167-169 (registration)MCP server registration of the 'search-maps' tool using server.tool(), specifying name, description, input schema, and handler function.server.tool( "search-maps", "Search Google Maps for locations and businesses.",