Repository avatar
AI Tools
v0.30.0
active

ratesspot

io.github.Nimisoere/ratesspot

Booking engine for rooms, desks, sessions and courses: listings, rates, availability and bookings.

Documentation

Build on RatesSpot

RatesSpot is a booking engine for anything people book: rooms by the night, desks by the day, sessions by the hour, places on a course. This repository has everything you need to build on it. MIT licensed.

packages/sdk@ratesspot/sdk: a typed TypeScript client for the API, and webhook signature verification
packages/mcp@ratesspot/mcp: the MCP server, so Claude and other AI assistants can set up a business and run its bookings
apps/booking-pageThe hosted booking page (book.ratesspot.com), built only on the SDK. Fork it to build a booking site
examples/booking-alertsA complete app that businesses install with OAuth, listening to webhooks

Start

  1. Create a test business and get test API keys: app.ratesspot.com/start.

  2. Read the docs: ratesspot.com/docs, and the API reference at api.ratesspot.com/docs (generated from the OpenAPI spec).

  3. Clone this repo (Node 26):

    npm install
    npm run typecheck
    
  4. Run the booking page with SITE_URL set to its public address (e.g. https://book.example.com): it's used for payment return links, canonical links and sitemaps. RATESSPOT_API_URL defaults to https://api.ratesspot.com.

Three ways to build

  • A booking site for one business: use its API keys (publishable in the browser, secret on your server). Start from apps/booking-page, or any framework with the SDK.
  • An app many businesses install (invoicing, loyalty, messaging, channel managers): register an OAuth app in the dashboard under Apps. Start from examples/booking-alerts.
  • AI assistants: add https://api.ratesspot.com/mcp to Claude as a custom connector, or run packages/mcp yourself with an API key.

Apps only ever use the public API, webhooks and OAuth: the same rules RatesSpot's own plugins follow.

Keeping types current

The SDK and MCP types are generated from the live API description:

npm run api-types

Contributing

Issues and pull requests are welcome: bugs, examples, and anything the API can't do that your app needs. Security problems: security@ratesspot.com, not a public issue.

Licence

MIT, copyright Nimisoere Tekena-Lawson. RatesSpot's engine itself is separate and not in this repository.

NPM
@ratesspot/mcp
Install Command
npm install @ratesspot/mcp

Remote