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.
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
Markdown
[](/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
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
- # Build on RatesSpot
- [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.
- | | |
- |---|---|
- | [`packages/sdk`](packages/sdk) | `@ratesspot/sdk`: a typed TypeScript client for the API, and webhook signature verification |
- | [`packages/mcp`](packages/mcp) | `@ratesspot/mcp`: the MCP server, so Claude and other AI assistants can set up a business and run its bookings |
- | [`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 |
- | [`examples/booking-alerts`](examples/booking-alerts) | A 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](https://app.ratesspot.com/start).
- 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)).
- 3. Clone this repo (Node 26):
- ```sh
- 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:
- ```sh
- 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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.