Skip to content
Back to search

ratesspot-dev

Build on RatesSpot: TypeScript SDK, MCP server, booking page template and example apps (MIT)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Nimisoere/ratesspot-dev with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Nimisoere/ratesspot-dev'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nimisoere--ratesspot-dev/badge.svg)](/listings/nimisoere--ratesspot-dev)

HTML

<a href="/listings/nimisoere--ratesspot-dev"><img src="/api/listings/nimisoere--ratesspot-dev/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 47 lines
  1. # Build on RatesSpot
  2. [RatesSpot](https://ratesspot.com) 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.
  3. | | |
  4. |---|---|
  5. | [`packages/sdk`](packages/sdk) | `@ratesspot/sdk`: a typed TypeScript client for the API, and webhook signature verification |
  6. | [`packages/mcp`](packages/mcp) | `@ratesspot/mcp`: the MCP server, so Claude and other AI assistants can set up a business and run its bookings |
  7. | [`apps/booking-page`](apps/booking-page) | The hosted booking page (book.ratesspot.com), built only on the SDK. Fork it to build a booking site |
  8. | [`examples/booking-alerts`](examples/booking-alerts) | A complete app that businesses install with OAuth, listening to webhooks |
  9. ## Start
  10. 1. Create a test business and get test API keys: [app.ratesspot.com/start](https://app.ratesspot.com/start).
  11. 2. Read the docs: [ratesspot.com/docs](https://www.ratesspot.com/docs), and the API reference at [api.ratesspot.com/docs](https://api.ratesspot.com/docs) (generated from the [OpenAPI spec](https://api.ratesspot.com/openapi.json)).
  12. 3. Clone this repo (Node 26):
  13. ```sh
  14. npm install
  15. npm run typecheck
  16. ```
  17. 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`.
  18. ## Three ways to build
  19. - **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.
  20. - **An app many businesses install** (invoicing, loyalty, messaging, channel managers): register an OAuth app in the dashboard under **Apps**. Start from `examples/booking-alerts`.
  21. - **AI assistants:** add `https://api.ratesspot.com/mcp` to Claude as a custom connector, or run `packages/mcp` yourself with an API key.
  22. Apps only ever use the public API, webhooks and OAuth: the same rules RatesSpot's own plugins follow.
  23. ## Keeping types current
  24. The SDK and MCP types are generated from the live API description:
  25. ```sh
  26. npm run api-types
  27. ```
  28. ## Contributing
  29. 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.
  30. ## Licence
  31. MIT, copyright Nimisoere Tekena-Lawson. RatesSpot's engine itself is separate and not in this repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.