Developer Docs

Krawl NearBy is an MCP server. Connect any AI agent to discover and book local health & beauty services.

Krawl exposes an MCP server for AI agents. Connect any compatible client and your assistant can search local London shops, check availability, and book on behalf of the user.

Quick Start

Claude (web / desktop / mobile)
  1. 1. Click Add to Claude below
  2. 2. Paste the server URL when prompted
  3. 3. Sign in with your Krawl account to authorise
Add to Claude →
https://nearby-krawl.onrender.com/mcp
Cursor

One click to install — opens Cursor and pre-fills the MCP config.

Add to Cursor →
ChatGPT / other MCP clients

Paste the server URL into your client's MCP settings:

https://nearby-krawl.onrender.com/mcp

In ChatGPT: Settings → Connectors → Add custom connector

Tools

search_businesses

Find businesses by location, category, or keyword. Supports geo search with radius.

Required: none
Optional: query, category, latitude, longitude, radius_km, available_after, available_before, limit
get_business_profile

Get full details: services, pricing, hours, reviews.

Required: business_id
Optional: —
get_availability

Check real-time slots for a date range (max 14 days). Filter by morning/afternoon/evening.

Required: business_id, date_from, date_to
Optional: service_id, preferred_times
book_appointment

Book a slot and get a confirmation reference. Race-condition safe.

Required: business_id, service_id, slot_id, customer_name, customer_email
Optional: customer_phone, notes

Authentication

OAuth 2.1 with PKCE (S256). Discovery endpoint:

GET https://nearby-krawl.onrender.com/.well-known/openid-configuration

• Access tokens expire after 15 minutes

• Refresh tokens last 30 days

• Supported grant types: authorization_code, refresh_token

Rate Limits

TierQueries/monthRate limit
Free1,000100 req/min
ProUnlimited1,000 req/min

Try it now

Hit the demo endpoint to see sample data:

GET https://nearby-krawl.onrender.com/api/v1/demo
View on GitHub← Back to home