@roompanda/mcp
README.md
# @roompanda/mcp
A [Model Context Protocol](https://modelcontextprotocol.io) server for the [Roompanda](https://roompanda.com) booking API. Point any MCP-compatible AI client at it and the agent can search availability, price rooms, and make **real** bookings — scoped to a single property by the API key.
Built on [`@roompanda/sdk`](https://github.com/daviesevan-svg/roompanda-sdk).
## Use it
Add to your MCP client (e.g. Claude Desktop `claude_desktop_config.json`):
```json
{
"mcpServers": {
"roompanda": {
"command": "npx",
"args": ["-y", "@roompanda/mcp"],
"env": { "ROOMPANDA_API_KEY": "sk_live_…" }
}
}
}
```
(Use an `sk_test_…` key while developing — bookings are simulated.)
## Tools
| Tool | Does |
| --- | --- |
| `get_property` | The connected property |
| `get_calendar` | Per-date open/closed/min-stay (date picker) |
| `list_rooms` | Room content, photos, facilities |
| `search_availability` | Bookable rooms + priced rates for a stay |
| `list_rates` | Rate plans & cancellation policies |
| `list_extras` | Add-ons / upsells |
| `create_booking` | Make a booking (returns a `payment_url` if a deposit is due) |
| `get_booking` | Retrieve a booking |
| `list_bookings` | List bookings |
## Config
| Env | |
| --- | --- |
| `ROOMPANDA_API_KEY` | **required** — `sk_live_…` or `sk_test_…` |
| `ROOMPANDA_BASE_URL` | optional API base override |
## License
MIT
TDQS
A3.7/5.0
Scored across 9 tools
Disambiguation5/5
Each tool has a clearly distinct purpose: creating bookings, retrieving them, checking availability, listing rooms/rates/extras, and property info. There is no confusion or overlap.
Naming Consistency5/5
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_booking, list_rooms, search_availability), making them predictable and easy to understand.
Tool Count5/5
9 tools is well-scoped for a property management and booking system. Each tool covers a necessary operation without excess or deficiency.
Completeness4/5
The set covers the core workflow (search, create, retrieve, list bookings, and property details). Minor gaps exist: no update or cancel booking, but these are secondary operations.
Maintenance
ActivityStale
ResponsivenessNo issues