MCPサーバー

Shortlist Pass Local Businesses

com.shortlistpass/local-businesses
コマース・小売 公開・接続可能 MCP 2025-11-25

このMCPでできること

Searches Myrtle Beach local businesses, retrieves menus and events, and starts customer orders through business checkout pages.

get_business
Get a business
Returns the public profile of one Shortlist business: name, type, description, town, phone, website, page URL, hours (fixed locations only), whether online ordering is open, and the order page URL when it is. Mobile businesses (food trucks) have no fixed address; their locations are the upcoming stops in the upcoming-events data.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subdomain'], 'properties': {'subdomain': {'type': 'string', 'maxLength': 63, 'minLength': 1, 'description': 'The business subdomain, e.g. "nitos" for nitos.shortlistpass.com'}}}
get_menu
Get the menu
Returns the current public menu of one business: every active item with name, description, price, category, tags, a sold-out flag and an image URL. Prices are in US dollars. For a business with menu_source "event" (food trucks), this is the full catalog of everything it sells; what is sold on a given day is listed per stop in the upcoming-events data, and the note field states this. The response includes the business summary with the order page URL when ordering is open.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subdomain'], 'properties': {'subdomain': {'type': 'string', 'maxLength': 63, 'minLength': 1, 'description': 'The business subdomain, e.g. "nitos"'}}}
get_upcoming_events
Get upcoming events and stops
Returns the upcoming published events and stops for one business; for a food truck these are its locations. Each has a name, ISO start and end with the local offset, location name and address, whether pre-orders are open for that stop, the pickup time slots still available with remaining capacity (null means no cap), and a menu with menu_status: "set" means the items listed are what is sold at that stop and their offering ids are accepted by start_order for that stop; "not_live" means the business has not put a menu on that stop yet, the menu is empty, menu_note carries the explanation, and start_order does not accept the stop; "catalog" means a fixed business whose standing menu applies. Recurring events carry a recurrence description and the next date. Cancelled and test events are not included.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subdomain'], 'properties': {'subdomain': {'type': 'string', 'maxLength': 63, 'minLength': 1, 'description': 'The business subdomain, e.g. "nitos"'}}}
search_businesses
Search Shortlist businesses
Searches real local businesses on Shortlist Pass (food trucks, restaurants, shops, HOAs and more). Optional filters: a town slug (e.g. "myrtle-beach"), a business category key (e.g. "food_truck", "restaurant", "bakery"), and a free-text query matched against the name, headline and type. Returns up to 25 matches, each with its subdomain, which is the identifier the other tools take. Demo and test pages are not included.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'town': {'type': 'string', 'maxLength': 80, 'description': 'Town slug, e.g. "myrtle-beach"'}, 'query': {'type': 'string', 'maxLength': 80, 'description': 'Free-text query, e.g. "empanadas"'}, 'category': {'type': 'string', 'maxLength': 80, 'description': 'Business category key, e.g. "food_truck"'}}}
start_order
Start an order for a customer
Creates a short-lived cart for a customer at one Shortlist business and returns a cart_url on the business's own page, where the customer reviews the order and pays through the business's checkout. Input is offering ids and quantities; prices are not accepted. The server prices every line from the menu, applies the business's deals and tax, and returns the resulting quote. For businesses with menu_source "event" (food trucks), event_id is required and identifies one upcoming stop; the offering ids accepted are those listed in that stop's menu in the upcoming-events data, and pickup_time is one of that stop's open pickup_slots. A stop whose menu_status is "not_live" is refused. The cart expires in 30 minutes. This tool does not accept payment details or addresses; payment happens on the business's page at the returned cart_url. In the quote, total_before_tip excludes the optional tip, which the customer chooses on the checkout page; quote.tip.note states the business's suggested percentage. agent.name is recorded on the cart and the order so the business can see which assistant helped.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subdomain', 'items', 'agent'], 'properties': {'agent': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 60, 'minLength': 1}}, 'description': 'The name of the assistant placing the order, e.g. { "name": "Claude" }'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['offering_id', 'quantity'], 'properties': {'options': {'type': 'object', 'description': "The offering's own variant or modifier choices, by option value or label", 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'quantity': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Whole number, 1 to 100'}, 'offering_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "An offering id from the stop's menu (or from the menu results for a fixed business)"}}}, 'maxItems': 12, 'minItems': 1}, 'customer': {'type': 'object', 'properties': {'name': {'type': 'string', 'maxLength': 80}, 'email': {'type': 'string', 'maxLength': 120}, 'phone': {'type': 'string', 'maxLength': 30}}, 'description': 'Customer details, if provided; pre-filled on the order sheet'}, 'event_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'A stop id from the upcoming-events results. Required for businesses with menu_source "event".'}, 'subdomain': {'type': 'string', 'maxLength': 63, 'minLength': 1, 'description': 'The business subdomain, e.g. "nitos"'}, 'pickup_time': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'One of the stop\'s open pickup_slots, "HH:MM" 24-hour'}}}
追加
start_order
2026年10月1日2:40
追加
get_upcoming_events
2026年10月1日2:40
追加
get_menu
2026年10月1日2:40
追加
get_business
2026年10月1日2:40
追加
search_businesses
2026年10月1日2:40