# Washlib MCP Server

Official [Model Context Protocol](https://modelcontextprotocol.io) server for [Washlib](https://www.washlib.com) — a car-wash booking marketplace in France. It gives AI agents read-only access to the live catalog: wash centers, services and starting prices, real-time availability, and (with phone verification) the caller's own booking.

**Remote endpoint (Streamable HTTP, no API key):**

```
https://www.washlib.com/api/mcp
```

## Quick start

**Claude Code**

```bash
claude mcp add --transport http washlib https://www.washlib.com/api/mcp
```

**Cursor / VS Code / any MCP client (JSON config)**

```json
{
  "mcpServers": {
    "washlib": {
      "url": "https://www.washlib.com/api/mcp"
    }
  }
}
```

No account, token, or configuration is required for the catalog and availability tools.

## Tools

| Tool | Description | Auth |
|------|-------------|------|
| `find_centers` | List active car-wash centers within `radiusKm` of a latitude/longitude, nearest first. | none |
| `get_services` | List the services a center offers with a starting price each. | none |
| `search_available_slots` | Find open time slots near a location on a given day, with busyness levels. | none |
| `recommend_wash` | Recommend a wash formula for a vehicle given dirt level and season (pure guidance, no booking). | none |
| `get_booking` | Retrieve a booking the caller owns. | Firebase phone-OTP token (`Authorization: Bearer <idToken>`); the booking is only returned when its phone number matches the verified caller. |

## Resources

| URI | Content |
|-----|---------|
| `washlib://centers` | All active wash centers (public catalog) |
| `washlib://services` | Service catalog (without prices) |
| `washlib://pricing` | Price ranges per service type across the network |
| `washlib://faq` | Frequently asked questions (French) |

## Design notes

- **Read-only by design.** There are deliberately no booking-mutation tools; booking happens on [washlib.com](https://www.washlib.com). The server is safe to expose to any agent.
- **Privacy.** The only PII-touching tool (`get_booking`) requires a verified phone identity and returns only the caller's own booking.
- **Locale.** Washlib serves the French market: tool titles and FAQ content are in French, tool descriptions and parameters are in English, dates use the `Europe/Paris` timezone.

## Related machine-readable surfaces

- Public REST API: `https://www.washlib.com/api/public/` — OpenAPI spec at [`/api/openapi.json`](https://www.washlib.com/api/openapi.json)
- [`/llms.txt`](https://www.washlib.com/llms.txt) — canonical entry point for LLMs and agents

## Listings

- Official MCP Registry: [`com.washlib/washlib`](https://registry.modelcontextprotocol.io/v0/servers?search=com.washlib/washlib)
- Smithery: [benmahammed-islem/washlib](https://smithery.ai/servers/benmahammed-islem/washlib)

## About

This repository documents the hosted server; the implementation lives inside the Washlib application and is not open source. Questions or issues: open an issue here or see [washlib.com/contact](https://www.washlib.com/contact).