search_restaurants

Search for restaurants near a geographic point. Filter by cuisine, price, and minimum grade. Sort by grade or distance.

Tier: Free

Use cases

Find restaurants near a specific location (hotel, landmark, address)
Filter by cuisine type, price range, or quality threshold
Build location-aware restaurant discovery features

Parameters

Name	Type	Required	Default	Description
`latitude`	number	Yes	--	Latitude (-90 to 90)
`longitude`	number	Yes	--	Longitude (-180 to 180)
`radius_km`	number	No	2	Search radius in kilometers (max 10)
`cuisine`	string	No	--	Filter by cuisine (case-insensitive substring match, e.g., `"italian"`)
`price_level`	string	No	--	Filter by price: `"$"`, `"$$"`, `"$$$"`, or `"$$$$"`
`min_grade`	string	No	--	Minimum letter grade: `A+` through `F`
`sort`	string	No	`"grade"`	Sort order: `"grade"` (highest first) or `"distance"` (nearest first)
`limit`	number	No	10	Maximum results to return (1-10)

Response

Field	Type	Description
`status`	`"ok"`	Response status
`results`	array	Matching restaurants (see fields below)
`total_in_area`	number	Total restaurants found in search area (before limit)

Result fields

Same lightweight fields as find_restaurant (seemor_id, name, address, coordinates, city, neighborhood, cuisine_tags, grade, coverage_level), plus:

Field	Type	Description
`distance_km`	number	Distance from search coordinates in kilometers (rounded to 2 decimal places)

This tool returns a lightweight response. For full details (TL;DR, summary, dimensional analysis), use lookup_restaurant with the returned seemor_id.

Example request

curl -X POST https://api.seemor.ai/api/mcp \
  -H "Authorization: Bearer sk_seemor_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_restaurants",
      "arguments": {
        "latitude": 51.5138,
        "longitude": -0.1318,
        "radius_km": 1,
        "cuisine": "italian",
        "min_grade": "B+",
        "sort": "grade",
        "limit": 5
      }
    }
  }'

Example response

{
  "status": "ok",
  "results": [
    {
      "seemor_id": "a1b2c3d4-...",
      "name": "Bocca di Lupo",
      "address": "12 Archer St, London W1D 7BB",
      "coordinates": { "lat": 51.5115, "lng": -0.1340 },
      "city": "London",
      "neighborhood": "Soho",
      "cuisine_tags": ["italian"],
      "grade": "A-",
      "coverage_level": "full",
      "distance_km": 0.3
    }
  ],
  "total_in_area": 42
}

Notes

The grade scale from highest to lowest: A+, A, A-, B+, B, B-, C+, C, C-, D, F.
cuisine is a substring match, so "thai" matches both "thai" and "northern thai".
Results use the same lightweight format as find_restaurant (no grade_label, tldr, or seemor_url). Use lookup_restaurant for full details.

search_restaurants

On this page