MCP 서버

NUM

com.itsnum/num
검색 및 리서치 여행 및 호스피탈리티 공개 · 연결 가능 MCP 2026-07-28

이 MCP로 할 수 있는 일

Searches a directory of travel-related places and provides venue details, booking instructions, and business submission workflows.

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.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'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_license_photo
License one use of a photo
Buys one use of one photo from this account's prepaid photo wallet and returns the license and a download link to the file (metadata removed). max_price_cents is the most the operator agreed to pay; a higher current price is refused with the quote and nothing is charged. Re-sending the same idempotency_key returns the same license instead of buying again. Spending is capped per UTC day. While NUM's licensing is in its test run, purchases use test credit and no money moves; the response says test: true.
파괴적 작업 외부 접근 가능
입력 스키마
{'type': 'object', 'required': ['photo_id', 'use', 'max_price_cents'], 'properties': {'use': {'enum': ['social', 'web', 'ad', 'ai_training'], 'type': 'string'}, 'photo_id': {'type': 'string', 'description': 'From num_search_photos.'}, 'idempotency_key': {'type': 'string', 'description': 'Your own key for this purchase; a retry with the same key never buys twice.'}, 'max_price_cents': {'type': 'integer', 'minimum': 1, 'description': 'The most the operator agreed to pay for this use, in US cents.'}}}
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.
읽기 전용 멱등성
입력 스키마
{'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.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'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_photo_wallet
Photo wallet and licenses
This account's photo wallet balance (US cents, plus test credit), what it spent today against the daily cap, and the licenses it holds. Free and unmetered. Adding credit is POST /api/agent/photos/topup, which returns a checkout link a person pays.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
num_quote_photo
Get the price and terms for one use of a photo
The current price in US cents and the full license terms for one use of one photo. Nothing is charged. Counts against the daily read quota.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', 'required': ['photo_id', 'use'], 'properties': {'use': {'enum': ['social', 'web', 'ad', 'ai_training'], 'type': 'string'}, 'photo_id': {'type': 'string', 'description': 'From num_search_photos.'}}}
num_search_photos
Search licensable photos of places
Search photos of real places taken by NUM travelers and offered for licensing per use. Each result has a photo_id, a preview URL, the place (name, city, area, category), the month it was taken, the photographer's public name and the price in US cents for each use: social (one post), web (one page), ad (one campaign) and ai_training (one dataset). A price of null means that use is not offered. Every photo shows a place with no recognisable person and was checked by a person; results never include coordinates or exact dates. use=ai_training returns only photos whose photographer allows AI training. Each call counts against the daily read quota.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Free text matched against the place name.'}, 'use': {'enum': ['social', 'web', 'ad', 'ai_training'], 'type': 'string', 'description': 'Only photos offered for this use.'}, 'city': {'type': 'string', 'description': "A NUM destination or neighbourhood, e.g. 'London' or 'Silom'."}, 'kind': {'enum': ['storefront', 'interior', 'menu', 'food_drink', 'view', 'room', 'hours', 'signage', 'other'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'category': {'type': 'string', 'description': "e.g. 'Restaurant', 'Bar', 'Hotel'."}, 'place_id': {'type': 'string', 'description': 'Only photos of this place (from num_search_places).'}}}
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.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'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.
파괴적 작업 외부 접근 가능
입력 스키마
{'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.
파괴적 작업 외부 접근 가능
입력 스키마
{'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.'}}}
추가됨
num_photo_wallet
2026년 10월 5일 2:54 AM
추가됨
num_license_photo
2026년 10월 5일 2:54 AM
추가됨
num_quote_photo
2026년 10월 5일 2:54 AM
추가됨
num_search_photos
2026년 10월 5일 2:54 AM
변경됨
num_get_place
2026년 9월 27일 2:52 AM
추가됨
num_list_destinations
2026년 9월 27일 2:52 AM
변경됨
num_search_places
2026년 9월 27일 2:52 AM
변경됨
num_list_submissions
2026년 9월 17일 12:59 PM
변경됨
num_submit_promo
2026년 9월 17일 12:59 PM
변경됨
num_submit_business
2026년 9월 17일 12:59 PM
변경됨
num_get_place
2026년 9월 17일 12:59 PM
변경됨
num_search_places
2026년 9월 17일 12:59 PM
추가됨
num_list_submissions
2026년 9월 17일 12:35 PM
추가됨
num_submit_promo
2026년 9월 17일 12:35 PM
추가됨
num_submit_business
2026년 9월 17일 12:35 PM
추가됨
num_get_place
2026년 9월 17일 12:35 PM
추가됨
num_search_places
2026년 9월 17일 12:35 PM