MCP Server
NUM
com.itsnum/num
What this MCP does
Searches a directory of travel-related places and provides venue details, booking instructions, and business submission workflows.
Capabilities
Tools
6
tools
num_get_place
Get place details and how to book it
Full record for one place, by the place_id that num_search_places returned, including HOW TO BOOK IT on the venue's own terms. `booking.method` is one of: request (the venue takes requests through NUM and confirms each one itself), venue_system (send the traveller to booking.url, prefilled when you pass party_size, date and time), phone (the number is for the traveller to call), not_through_num, closed, unknown. Follow booking.guidance exactly. If open_status.closed is true, NUM holds evidence the place has gone: do not send anyone there. accolades carry their source; menu is the owner's own list and prices. Each call counts against the daily read quota.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['place_id'], 'properties': {'date': {'type': 'string', 'description': "Optional: YYYY-MM-DD, to prefill the venue's booking page."}, 'time': {'type': 'string', 'description': 'Optional: HH:MM 24-hour, local to the venue.'}, 'place_id': {'type': 'string', 'description': 'The place_id returned by num_search_places.'}, 'party_size': {'type': 'integer', 'maximum': 40, 'minimum': 1, 'description': "Optional: people in the party, to prefill the venue's booking page."}}}
num_list_destinations
List NUM's destinations
Every destination NUM covers, with its country. Use a destination's name or slug as num_search_places city. Free, unmetered, and needs no key.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
num_list_submissions
List your submissions
Lists the businesses and promotions this account has submitted, with the reviewer's decision on each. Free and unmetered.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'status': {'enum': ['pending', 'approved', 'rejected', 'duplicate', 'withdrawn'], 'type': 'string'}}}
num_search_places
Search places
Search NUM's travel directory: more than 2.5 million places — restaurants, bars, hotels, spas, tours and shops, deepest in Thailand and the UK. Say where to look: city (one of NUM's destinations — see num_list_destinations) or country; then narrow with q, area and category. Places NUM knows have closed are never returned. Returns name, category, address, phone, website, coordinates and whether the owner has claimed the listing; call num_get_place for how to book one. Each call counts against the daily read quota.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Free text matched against the place name.'}, 'area': {'type': 'string', 'description': "A neighbourhood inside the destination, e.g. 'Kata' or 'Soho'."}, 'city': {'type': 'string', 'description': "A NUM destination, e.g. 'Phuket', 'Edinburgh', 'Bangkok', 'London'. Required unless country is given."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results, default 20, cap 50.'}, 'country': {'type': 'string', 'description': "ISO-2 code or name, e.g. 'TH' or 'Thailand'. Searches every NUM destination in that country."}, 'category': {'type': 'string', 'description': "e.g. 'Restaurant', 'Bar', 'Hotel', 'Spa', 'Tour'."}}}
num_submit_business
Submit a business for review
Submit a business to NUM for review. Free and unmetered. A person at 5arz reviews every submission before any traveller sees it, so the result is status 'pending_review', never an immediate listing. 'relationship' records whether the submitter owns the business, was engaged by the owner, or is a third party; reviewers verify it. Contact details must be ones the business has published — submissions with guessed or derived contact details are rejected. Re-sending the same external_ref updates the pending submission instead of creating a duplicate.
Destructive
Open world
Input schema
{'type': 'object', 'required': ['relationship', 'name', 'country', 'city'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string', 'description': 'Trading name as it appears on the door.'}, 'email': {'type': 'string', 'description': 'Only if the business has published it. Do not derive it from the domain name.'}, 'hours': {'type': 'string'}, 'phone': {'type': 'string'}, 'address': {'type': 'string'}, 'country': {'type': 'string'}, 'website': {'type': 'string'}, 'vertical': {'type': 'string', 'description': 'restaurant, cafe, bar, hotel, spa, boat, tour, shop, transport, clinic, gym, attraction, other…'}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}, 'price_range': {'type': 'string'}, 'callback_url': {'type': 'string', 'description': 'NUM POSTs the review decision here.'}, 'external_ref': {'type': 'string', 'description': 'Your own reference for this business. Re-sending it edits the pending submission instead of creating a duplicate.'}, 'relationship': {'enum': ['owner', 'authorized_agent', 'third_party'], 'type': 'string', 'description': "'owner' if you run it, 'authorized_agent' if the owner engaged you, 'third_party' if you neither own nor represent it."}}}
num_submit_promo
Submit a promotion for review
Attach a promotion, special, event or ad to a business previously submitted by the same account. Free and unmetered. A person reviews it before it is shown to anyone. Re-sending the same promo_ref updates the pending promotion instead of creating a duplicate.
Destructive
Open world
Input schema
{'type': 'object', 'required': ['title'], 'properties': {'kind': {'enum': ['promo', 'special', 'event', 'ad'], 'type': 'string'}, 'terms': {'type': 'string'}, 'title': {'type': 'string', 'description': 'The single line a traveller reads.'}, 'detail': {'type': 'string'}, 'ends_at': {'type': 'string'}, 'promo_ref': {'type': 'string', 'description': 'Your own reference for this promotion, for idempotent edits.'}, 'starts_at': {'type': 'string', 'description': '2026-08-01 or 2026-08-01T18:00:00Z.'}, 'discount_pct': {'type': 'integer', 'maximum': 90, 'minimum': 0}, 'external_ref': {'type': 'string', 'description': 'Alternative to submission_id: the reference you used for the business.'}, 'submission_id': {'type': 'string', 'description': 'From num_submit_business.'}}}
History
Recent tool changes
Changed
num_get_place
Sept. 27, 2026, 2:52 a.m.
Added
num_list_destinations
Sept. 27, 2026, 2:52 a.m.
Changed
num_search_places
Sept. 27, 2026, 2:52 a.m.
Changed
num_list_submissions
Sept. 17, 2026, 12:59 p.m.
Changed
num_submit_promo
Sept. 17, 2026, 12:59 p.m.
Changed
num_submit_business
Sept. 17, 2026, 12:59 p.m.
Changed
num_get_place
Sept. 17, 2026, 12:59 p.m.
Changed
num_search_places
Sept. 17, 2026, 12:59 p.m.
Added
num_list_submissions
Sept. 17, 2026, 12:35 p.m.
Added
num_submit_promo
Sept. 17, 2026, 12:35 p.m.
Added
num_submit_business
Sept. 17, 2026, 12:35 p.m.
Added
num_get_place
Sept. 17, 2026, 12:35 p.m.
Added
num_search_places
Sept. 17, 2026, 12:35 p.m.
Discover
Similar MCP servers
AI 代理人任務中樞
com.penguindriver/hub
Aggregates Taiwan-focused tools for AI service comparisons, cryptocurrency data, game information, health guidance, and other con…
SeaWeb
tech.seaweb/seaweb
Searches and extracts web information about entities and travel locations, including restaurants, salons, tourist conditions, dis…
Yelp
io.github.pipeworx-io/yelp
Searches Yelp businesses and returns business details, ratings, reviews, categories, locations, hours, contact information, and c…
Maxwell Directory (x402 + MCP)
ai.maxwellinternational/data
Provides searchable paid and free data products covering companies, legislation, courts, patents, markets, local providers, resta…
MONO Social
io.github.junoventures/mono-juno-ventures
Provides directory search for local places, events, listings, services, offers, bookings, reservations, tickets, and products.
Campo Belo
io.github.junoventures/campobelo-sampa-br
Provides Campo Belo local discovery for places, events, menus, offers, services, bookings, reservations, tickets, and purchases.
Bom Retiro
io.github.junoventures/bomretiro-sampa-br
Provides Bom Retiro local place, event, menu, offer, service, booking, reservation, ticketing, and checkout capabilities.
Bogeyland
io.github.junoventures/bogeyland-golf
Provides directory search for places, events, services, offers, bookings, reservations, tickets, menus, and purchases.