Tools
ask_about_restaurant
Natural-language Q&A about a specific restaurant
ask_about_restaurant
Ask a natural-language question about a specific restaurant and get an answer grounded in Seemor's analysis data.
Tier: Premium ($50/1K calls)
Use cases
- Answer specific user questions about a restaurant ("Is this place good for kids?", "What should I order?")
- Build conversational restaurant information features
- Get quick, structured answers without parsing the full analysis
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
restaurant_id | string | Yes | -- | Seemor restaurant ID (UUID) |
question | string | Yes | -- | Natural-language question about the restaurant |
Response
| Field | Type | Possible values | Description |
|---|---|---|---|
status | string | "ok", "error", "not_found" | Response status |
restaurant_id | string | UUID | Restaurant ID |
restaurant_name | string | -- | Restaurant name |
question | string | -- | The question as submitted |
answer | string | -- | Natural-language answer grounded in Seemor's data |
category | string | "general", "atmosphere", "dishes", "value", "dietary", "accessibility", "reservations", "know_before", "directions", "availability", "contact" | Question category |
source | string | "cached", "generated" | cached = previously answered question. generated = answered on-the-fly. |
seemor_url | string | -- | Link to the restaurant's Seemor page |
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": "ask_about_restaurant",
"arguments": {
"restaurant_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"question": "Is this place good for a business dinner?"
}
}
}'Example response
{
"status": "ok",
"restaurant_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"restaurant_name": "Dishoom Shoreditch",
"question": "Is this place good for a business dinner?",
"answer": "Dishoom Shoreditch works for a casual business meal but not a formal one. The atmosphere is lively and energetic, which means it can get loud during peak hours. The food is excellent and shareable, which keeps conversation flowing. For a more formal business setting, you might want somewhere quieter.",
"category": "atmosphere",
"source": "generated",
"seemor_url": "https://app.seemor.ai/restaurant/dishoom-shoreditch-london"
}Notes
- Generated answers (
source: "generated") are created on-the-fly and may take 2-4 seconds. - Cached answers (
source: "cached") are previously generated answers stored for fast retrieval. - Returns
status: "not_found"if the restaurant ID is invalid, or an error if the restaurant hasn't been analyzed yet. Neither is billed. - Requires a paid API key. Free keys receive a blocking error.