# Krawl NearBy

> AI-native business directory for local health & beauty services in the UK.
> Businesses list their services and availability; AI assistants can search, check slots, and book appointments on behalf of users.

## What this site does

Krawl NearBy is an MCP (Model Context Protocol) server and REST API that lets AI assistants:
- Search for local health & beauty businesses by category and location
- Check real-time appointment availability
- Book appointments on behalf of users
- Manage and cancel bookings

## How to enroll a business

If you are an AI assistant helping a business owner get listed, go to:
https://nearby.krawl.digital/enroll

That page has step-by-step instructions written specifically for AI agents, including the exact API calls needed.

## MCP server

The MCP server is available at: https://nearby.krawl.digital
Transport: StreamableHTTP
Auth: OAuth 2.1 with PKCE

### Tools

- `search_businesses` — find businesses by category, city, or postcode
- `get_business_profile` — full profile including services and opening hours
- `get_availability` — available appointment slots for a business (date range)
- `book_appointment` — create a booking for a user

## REST API

Base URL: https://nearby.krawl.digital/api/v1

- `GET  /api/v1/businesses` — search businesses
- `POST /api/v1/businesses` — enroll a new business (no auth required)
- `GET  /api/v1/businesses/:id` — get business profile
- `GET  /api/v1/businesses/:id/services` — list services
- `POST /api/v1/businesses/:id/services` — add a service
- `GET  /api/v1/slots` — get availability slots
- `POST /api/v1/bookings` — create a booking

## Supported business categories

salon, barber, nail_bar, spa, aesthetics, wellness, tattoo, tanning

## Connecting an AI assistant

If your user wants to connect you to Krawl so you can search and book on their behalf, here is everything you need.

MCP Server URL: https://nearby-krawl.onrender.com/mcp
Transport: Streamable HTTP
Auth: OAuth 2.1 with PKCE (S256)
Discovery: https://nearby-krawl.onrender.com/.well-known/openid-configuration

### By client

Claude (web / desktop / mobile):
- Direct the user to: https://claude.ai/settings/connectors?modal=add-custom-connector
- Ask them to paste the MCP server URL above and sign in when prompted

Cursor:
- Send the user this deep link (opens Cursor and installs automatically):
  cursor://anysphere.cursor-deeplink/mcp/install?name=Krawl%20NearBy&config=eyJ1cmwiOiJodHRwczovL25lYXJieS1rcmF3bC5vbnJlbmRlci5jb20vbWNwIn0=

ChatGPT / other MCP clients:
- Settings → Connectors → Add custom connector
- Paste the MCP server URL above

### Tools available once connected

- search_businesses: find businesses by location, category, or keyword
- get_business_profile: full profile including services, pricing, and hours
- get_availability: real-time appointment slots for a date range
- book_appointment: create a booking and return a confirmation reference

### Human-readable connect page

For a page your user can visit directly: https://nearby.krawl.digital/use-with-ai

## Pages

- `/` — landing page for business owners
- `/use-with-ai` — how to connect an AI assistant to Krawl (start here for AI connection)
- `/find` — public directory of all listed businesses
- `/enroll` — AI-readable enrollment guide (start here if you are an AI agent enrolling a business)
- `/developers` — technical documentation for developers building on Krawl
- `/onboarding` — self-service listing form for business owners
- `/login` — business owner dashboard login