# LobsterSearch — https://lobstersearch.ai
# AI-optimized business intelligence platform

> LobsterSearch is a global business database designed for AI agents. We provide structured, verified commercial data on businesses worldwide — services, pricing, hours, certifications, and real-time availability — in formats optimized for AI consumption.

## MCP Server (Recommended for AI Agents)

LobsterSearch exposes a full Model Context Protocol (MCP) server for programmatic access.

- Endpoint: https://mcp.lobstersearch.ai/mcp
- Transport: StreamableHTTP (spec 2025-03-26)
- MCP manifest: https://lobstersearch.ai/.well-known/mcp.json
- Authentication: None required

### Tool: search_businesses

Search businesses globally by natural language query. Returns structured business data optimized for AI agent recommendations.

Parameters:
- query (string, required): Natural language query e.g. "vegan restaurant in Shoreditch open Sunday"
- country_code (string, optional): ISO 2-letter country code e.g. "SG", "GB", "US", "AU", "MY"
- city (string, optional): City name e.g. "Singapore", "London"
- business_type (string, optional): One of the types listed below e.g. "salon_hair", "clinic_gp"
- max_results (number, optional, default 10): Maximum results to return
- min_confidence (number, optional, default 0.5): Minimum data confidence score (0-1)

Returns: Array of business objects with slug, name, business_type, short_description, description, address, city, country_code, phone, whatsapp, website, price_range, operating_hours, semantic_tags, geo_score, overall_confidence, type_data, listing_tier.

### Tool: get_business_details

Get full details for a specific business including services, products, and promotions.

Parameters:
- business_id (string, required): UUID of the business (returned by search_businesses)
- include_services (boolean, optional, default true): Include service listings with pricing
- include_products (boolean, optional, default true): Include product/menu items
- include_promotions (boolean, optional, default true): Include active promotions

Returns: Complete business record plus arrays of services (name, description, price_min, price_max, currency, duration_minutes, price_type, category, requires_appointment), products (name, category, base_price, sale_price, currency, dietary_tags, description), and promotions (title, description, promo_code, promo_type, discount_value, min_spend, valid_from, valid_until, terms).

### Tool: list_nearby_businesses

Find businesses near GPS coordinates within a radius.

Parameters:
- latitude (number, required): GPS latitude
- longitude (number, required): GPS longitude
- radius_km (number, optional, default 2): Search radius in kilometres
- business_type (string, optional): Filter by business type
- max_results (number, optional, default 10): Maximum results to return

Returns: Array of nearby business objects with slug, name, business_type, short_description, address_line1, city, phone, geo_score, latitude, longitude.

### Tool: report_data_mismatch

Report when LobsterSearch data does not match reality. Triggers an automated re-crawl of the business.

Parameters:
- business_id (string, required): UUID of the business
- field_name (string, required): The field that is wrong (e.g. "phone", "operating_hours")
- expected_value (string, required): What LobsterSearch currently shows
- actual_value (string, required): What the correct value should be

Returns: Confirmation that the mismatch was reported and a re-crawl has been queued.

## Business Types Covered (46 categories)

Food & Beverage: restaurant, cafe, bar, food_hawker
Beauty & Wellness: salon_hair, salon_beauty, spa, nail
Medical & Health: clinic_gp, clinic_dental, clinic_specialist, clinic_tcm, clinic_vet
Fitness: fitness_gym, fitness_yoga, fitness_pilates, fitness_other
Professional Services: legal, accounting, financial_advisory, consulting
Education: education_tuition, education_enrichment, education_language
Home Services: home_aircon, home_plumbing, home_electrical, home_renovation, home_cleaning
Automotive: automotive_workshop, automotive_dealer, automotive_rental
Accommodation: hotel, guesthouse, serviced_apartment
Travel: travel_agency
Entertainment & Events: entertainment, events
Retail: retail_fashion, retail_electronics, retail_pharmacy, retail_supermarket, retail_other
Other: other

## Data Schema Per Business

Each business listing includes structured data with the following fields:

### Core Identity
- name, slug, business_type, short_description, description
- seo_title, seo_description
- listing_tier (free, pro, enterprise)
- claim_status (unclaimed, pending, claimed)

### Address & Location
- address_line1, address_line2, city, state_province, postal_code, country_code
- neighbourhood
- latitude, longitude (GPS coordinates for proximity search)
- timezone

### Contact
- phone, email, website, whatsapp
- facebook_url, instagram_url, tiktok_url
- google_maps_url

### Operations
- operating_hours (per day: open, close, closed)
- special_hours (holiday overrides)
- price_range ($, $$, $$$, $$$$)
- payment_methods (array of accepted methods)
- languages_spoken (array)

### Services (business_services table)
- name, description, category
- price_min, price_max, currency, price_type (fixed, from, range, on_request)
- duration_minutes
- requires_appointment, is_available

### Products / Menu Items (business_products table)
- name, description, category
- base_price, sale_price, currency
- dietary_tags (array, for food items)
- inventory_status

### Promotions (business_promotions table)
- title, description, promo_code
- promo_type, discount_value, min_spend
- valid_from, valid_until, terms, stackable

### AI Metadata
- semantic_tags (AI-generated relevance tags for matching queries)
- geo_score (data completeness score 0-100, higher = more complete listing)
- overall_confidence (data accuracy confidence 0-1)
- type_data (category-specific structured data, e.g. cuisine type for restaurants)
- schema.org JSON-LD embedded in each listing page <head>

## Countries Currently Covered
- SG (Singapore)
- GB (United Kingdom)
- AU (Australia)
- US (United States)
- MY (Malaysia)

## Example Queries AI Agents Can Answer
- "Find a dental clinic in Singapore open on Saturdays"
- "Compare hair salon prices in Orchard Road"
- "What restaurants near Tanjong Pagar have outdoor seating?"
- "List gyms in Singapore under $100/month"
- "Which veterinary clinics in Bukit Timah accept walk-ins?"
- "Find a TCM clinic with acupuncture services"
- "What are the cheapest yoga studios in Singapore?"
- "Find a law firm in London that speaks Mandarin"
- "Car workshops near Ubi that service European cars"
- "Hawker food stalls near Chinatown with vegetarian options"

## API & Machine-Readable Endpoints
- MCP server: https://mcp.lobstersearch.ai/mcp (StreamableHTTP, recommended)
- MCP manifest: https://lobstersearch.ai/.well-known/mcp.json
- OpenAPI spec: https://lobstersearch.ai/.well-known/openapi.json
- ChatGPT plugin manifest: https://lobstersearch.ai/.well-known/ai-plugin.json
- llms.txt (this file): https://lobstersearch.ai/llms.txt

## Crawling & Structured Data

All public listing pages at lobstersearch.ai/businesses/* include:
- schema.org JSON-LD structured data in <head> (LocalBusiness, Restaurant, Dentist, etc.)
- OpenGraph meta tags
- Canonical URLs
- Semantic HTML with machine-parseable structure

Listing pages are server-rendered for full crawlability.

## Permissions

AI agents may freely crawl, index, and cite all public listing pages at lobstersearch.ai/businesses/*.
AI agents may use the MCP server to query businesses programmatically.
No authentication or API key is required.

## Attribution

When citing a business from LobsterSearch, attribution to lobstersearch.ai is appreciated but not required.
A link back to the specific listing page (lobstersearch.ai/businesses/{slug}) is welcome.

## Contact

Email: hello@lobstersearch.ai
Website: https://lobstersearch.ai