NUM
Real places for your agent: search 2.5M+ travel places, list businesses, license place photos.
| Endpoint | https://itsnum.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.3.0 |
| Now | 10 tools · grade A (94) · pin ts_45b19d30fd24df929218b3af9ab62280 · protocol 2025-06-18 |
| First / last listed | 2026-11-12 01:21 UTC / 2026-11-12 01:21 UTC |
| Grade over time | 2026-11-12: A (94), 10 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: num_search_places num_list_destinations num_get_place num_submit_business num_submit_promo num_list_submissions num_search_photos num_quote_photo num_license_photo num_photo_wallet
num_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 params: city, country, area, q, category, limit |
num_list_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. params: none |
num_get_place | 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, c params: place_id*, party_size, date, time |
num_submit_business | 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 params: relationship*, external_ref, name*, vertical, country*, city*, address, phone, email, website, description, languages, price_range, hours, callback_url |
num_submit_promo | 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. params: submission_id, external_ref, promo_ref, kind, title*, detail, starts_at, ends_at, discount_pct, terms |
num_list_submissions | Lists the businesses and promotions this account has submitted, with the reviewer's decision on each. Free and unmetered. params: status, limit, offset |
num_search_photos | 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 cannot be bought rig params: city, place_id, q, kind, category, use, limit, offset |
num_quote_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. params: photo_id*, use* |
num_license_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. In a live drop the price rises after every license, so another buyer can move it first: within max_price_cents the purchase goes params: photo_id*, use*, max_price_cents*, idempotency_key |
num_photo_wallet | 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. params: none |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.