@tkawen/ambulancedz-mcp

MCP server for Ambulance.dz — Algeria's 69-wilaya ambulance / medical-transport marketplace. Lets any MCP client (Claude Desktop, Claude Code, etc.) find ambulances, locate the nearest available one by GPS, estimate a trip's cost, and read live platform stats.

Tools

| 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 first) | | find_nearest_ambulance | Nearest available ambulances to a GPS point, with distance + ETA | | get_ambulance | Full details of one driver by id | | estimate_price | Estimated DZD cost range for a trip between two wilayas | | platform_stats | Drivers / verified / available / coverage / avg rating |

It talks to the public read-only JSON API at {BASE}/api/v1. No credentials needed.

Install & run

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

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": "node",
      "args": ["D:/PROJECTS/05-OTHER-PROJECTS/ambulancedz-mcp/src/index.js"]
    }
  }
}

Or, once published: "command": "npx", "args": ["-y", "@tkawen/ambulancedz-mcp"].

License

MIT © TKAWEN