@tkawen/ambulancedz-mcp

@tkawen/ambulancedz-mcp

MCP server for ambulancedz.com — Algeria's ambulance and medical-transport marketplace across all 69 wilayas. It lets any MCP client (Claude Desktop, Claude Code, …) find and vet ambulance drivers, locate the nearest available one by GPS, read a driver's reviews, estimate a trip's cost, check coverage, and set up recurring dialysis transport.

⚠️ Read this first

ambulancedz is a directory of private ambulance operators. It is not a government ambulance service and not an emergency dispatch centre. It does not send anyone, and it cannot guarantee availability or response time.

In a life-threatening emergency in Algeria, call these first:

Number	Service
14	الحماية المدنية — Civil Protection
16	الاستعجالات الطبية — SAMU (medical)
17	الأمن الوطني — National Police

Every tool that returns drivers also returns a safety object carrying these numbers, and emergency_numbers answers from a built-in constant even if the API is unreachable. If you extend this server, keep that property.

Tools (12)

Tool	Description
list_wilayas	All 69 wilayas with driver counts + how many are available now
list_communes	Communes of a wilaya (by id)
search_ambulances	Search drivers by wilaya / commune / service type / status / verified, with sorting
find_nearest_ambulance	Nearest available ambulances to a GPS point, with real distance + ETA
get_ambulance	Full details of one driver: phone, WhatsApp, plate, coordinates, gallery, member-since
get_ambulance_reviews	A driver's reviews plus the star distribution, so a rating can be reconciled against its evidence
estimate_price	Indicative DZD cost range for a trip between two wilayas
platform_stats	Drivers / verified / available / coverage / average rating
coverage_report	Per-wilaya coverage including the wilayas with no drivers at all
emergency_numbers	Algeria's national emergency numbers and what each is for
driver_join_info	For ambulance owners: trial length, plans and prices, payment methods, verification documents
request_recurring_booking	✍️ Register a recurring (dialysis) transport request — creates a pending booking

All tools are read-only except request_recurring_booking, and they are annotated as such (readOnlyHint) so clients can treat them accordingly.

Resources

URI	Contents
ambulancedz://safety	What the platform is and is not, plus the emergency numbers
ambulancedz://coverage	Live per-wilaya driver coverage

Prompts

Prompt	Purpose
find_ambulance	Guided, safety-first flow for finding an ambulance
plan_dialysis_transport	Guided flow for setting up recurring dialysis transport

Honesty guarantees

These are enforced by the API this server reads, and are worth preserving in any client that presents the data:

• A rating with no reviews behind it is returned as null, never as a score. get_ambulance_reviews returns a star breakdown that always sums to the reported total.
• Prices are ranges, not quotes. The platform is not party to the agreement between patient and driver, and takes no commission on trips.
• «موثّق» (verified) means a human reviewed the driver's licence, vehicle registration and vehicle photo. Drivers who are not verified are reported as not verified rather than being quietly presented the same way.
• Availability is whatever the driver last set — status and last_active_at are reported as-is, with no invented green dots.

Install & run

npm install
node src/index.js          # stdio MCP server
npm test                   # full smoke test against the live API

The smoke test creates one pending recurring booking to exercise the write path and prints its id — delete it from the admin panel afterwards.

Configure

Env	Default	Purpose
AMBULANCEDZ_BASE_URL	https://ambulancedz.com	Target platform base URL

Use with Claude Desktop / Claude Code

Add to your MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "ambulancedz": {
      "command": "npx",
      "args": ["-y", "@tkawen/ambulancedz-mcp"]
    }
  }
}

Running from a local checkout instead:

{
  "mcpServers": {
    "ambulancedz": {
      "command": "node",
      "args": ["D:/PROJECTS/05-OTHER-PROJECTS/ambulancedz-mcp/src/index.js"]
    }
  }
}

Underlying API

Public, read-only, no credentials: https://ambulancedz.com/api/v1

/wilayas · /wilayas/{id}/communes · /ambulances · /ambulances/nearest · /ambulances/{id} · /ambulances/{id}/reviews · /price-estimate · /stats · /coverage · /driver-plans · /emergency-numbers · POST /recurring-bookings (rate-limited)

License

MIT © TKAWEN