@shyzus/mcp-geocrafter 1.5.1 → 1.5.3

package/README.md

@@ -34,9 +34,9 @@ This application allows **ChatGPT** and other MCP clients to access geocoding se
 
 ### ✨ Features
 
-- 🔍 **Address to GPS** - Convert addresses to coordinates with multi-provider support
-- 📍 **GPS to Address** - Convert coordinates to addresses
-- 🔄 **Multi-Provider** - Google Geocoding API + Photon API (OpenStreetMap), selectable per request
+- 🔍 **Address to GPS** - `search_address_google` (recommended) + `search_address_photon` (fuzzy matching)
+- 📍 **GPS to Address** - `reverse_geocode_google` (recommended) + `reverse_geocode_photon`
+- 🔄 **Multi-Provider** - Dedicated tools per provider — the LLM picks the right one automatically
 - 🔗 **Geohash Encoding/Decoding** - Convert coordinates to geohash strings for location deduplication
 - 📏 **Distance Calculation** - Haversine formula to compute exact distance between two GPS points
 - 🏗️ **Modular Architecture** - Clean separation of concerns, reusable for future MCP servers
@@ -50,7 +50,7 @@ This application allows **ChatGPT** and other MCP clients to access geocoding se
 | **Google** (recommended) | POIs, businesses, intent-based queries ("gare ales france") | Requires API key, 10k free/month |
 | **Photon** | Typo-tolerant search on place/street names, no API key needed | Less accurate on POI resolution |
 
-The LLM automatically picks the best provider based on query type, or the user can force one (e.g. "use Google", "use Photon").
+Each provider has its own dedicated tools — the LLM sees both options and picks the right one. Users can also force a provider (e.g. "use Google", "use Photon").
 
 ### 💬 Usage examples
 
@@ -524,8 +524,8 @@ CORS_ORIGIN=*                      # CORS origin (default: * in dev, https://cha
   - **Server-side**: Set `GOOGLE_API_KEY` environment variable — all clients benefit automatically
   - **Per-request**: Pass `apiKey` parameter in the tool call — for N8N, automations, or when you don't control the server
 - **Photon**: Always available, no configuration needed. You can optionally self-host (set `PHOTON_BASE_URL`).
-- The `provider` parameter on `search_address` and `reverse_geocode` tools lets the LLM override the default per request.
-- The `apiKey` parameter is never logged, never stored, never returned in responses.
+- Each provider has **dedicated tools** (`search_address_google`, `search_address_photon`, etc.) — no `provider` parameter needed.
+- The `apiKey` parameter on Google tools is never logged, never stored, never returned in responses.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shyzus/mcp-geocrafter",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "GeoCrafter - MCP server for geocoding, reverse geocoding, geohash and distance calculation - Powered by Photon API",
   "type": "module",
   "main": "dist/index.js",