emergency-medicare-planner

The Emergency Medicare Planner MCP server provides tools to locate and evaluate medical facilities near a patient in emergency situations. It integrates with Google Maps to search for hospitals and clinics within a 10km radius, evaluate facility capabilities based on medical needs, and deliver real-time routing and availability information. Core tools include searchMedicalFacilities to find facilities by query and location, getMedicalFacilityDetails to retrieve hours, services, and contact information, calculateRouteToFacility to determine the fastest route including transport mode (driving, walking, transit, ambulance), and checkFacilityAvailability to verify current patient intake status given the urgency level. These capabilities enable step-by-step facility selection and traversal planning in urgent scenarios.

Prerequisites:

• Node.js and npm installed on your system
• A Google Maps API key with Places, Directions, Geocoding, Time Zone, and Distance Matrix APIs enabled

Option A: Install and run with npx (recommended)

1. Ensure you have an API key and set it when running (optional if using config):
   • npx @manolaz/emergency-medicare-planner-mcp-server
2. Run the server via npx (it pulls the package on demand): npx @manolaz/emergency-medicare-planner-mcp-server

Option B: Global installation

1. Install globally: npm install -g @manolaz/emergency-medicare-planner-mcp-server
2. Run after installation with your API key: GOOGLE_MAPS_API_KEY=your_api_key emergency-medicare-planner-mcp-server

Additional guidance:

• If you plan to configure Claude Desktop, you can set the mcpServers entry with the npx command and include the GOOGLE_MAPS_API_KEY in env as shown in the example configuration.

Environment variables and configuration tips:

• GOOGLE_MAPS_API_KEY is required for all facilities search and routing features. Ensure the key has Places, Directions, Geocoding, Time Zone, and Distance Matrix APIs enabled.
• When using the server in Claude Desktop, you can supply the key via the mcpServers.env section or export it in your shell before launching.
• If you encounter rate limits from Google Maps, consider caching results or increasing request intervals; the MCP server is designed to query facilities and routes efficiently but API quotas may apply.
• For debugging, you can enable verbose logs or prefix commands with DEBUG=emergency-medicare:* to surface detailed information about tool calls and responses.