NUM
Real places for your agent: search 2.5M+ travel places, list businesses, license place photos.
Connector by itsnum.com · Domain verified by the MCP Registry
Install
Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install connector/itsnum-com-num
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://itsnum.com/mcpRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 7 read · 0 write · 3 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Nothing to install (hosted)
- Runs as
- Hosted (remote endpoint)
Tools by what they do 10
From the running server's own tool list (tools/list) on Oct 25, 2026.
Read 7 · Look things up without changing anything.
num_get_placenum_list_destinationsnum_list_submissionsnum_photo_walletnum_quote_photonum_search_photosnum_search_places
Delete 3 · Delete, drop, revoke or wipe things.
num_license_photonum_submit_businessnum_submit_promo
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
Authorization
Network hosts it talks to 3
github.com· found in codeglama.ai· found in codeitsnum.com· found in remote endpoint, install command, code
Tools (10)
As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].
num_get_placeGet place details and how to book itread-onlyFull 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 l…
num_license_photoLicense one use of a photocan change or delete dataBuys 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 through at the new price, above it you get price_moved with the new quote and nothing is charged. Re-sending the same idempotency_key returns the same license instead of buying again. Spending is cap…
num_list_destinationsList NUM's destinationsread-onlyEvery destination NUM covers, with its country. Use a destination's name or slug as num_search_places city. Free, unmetered, and needs no key.
num_list_submissionsList your submissionsread-onlyLists the businesses and promotions this account has submitted, with the reviewer's decision on each. Free and unmetered.
num_photo_walletPhoto wallet and licensesread-onlyThis 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.
num_quote_photoGet the price and terms for one use of a photoread-onlyThe 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.
num_search_photosSearch licensable photos of placesread-onlySearch 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 right now. Business uses sell in live drops: a limited number of licenses over 3 days, the price rising 10% after each one; drop shows licenses left, the end time and the next price. Every photo shows a …
num_search_placesSearch placesread-onlySearch 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.
num_submit_businessSubmit a business for reviewcan change or delete dataSubmit 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.
num_submit_promoSubmit a promotion for reviewcan change or delete dataAttach 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.
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Last commit
- Sep 17, 2026 (1 month ago)
- Last release
- Oct 4, 2026 (24 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
com.itsnum/num- Version
- 1.3.0
- Auth
- Bearer token
- License
- MIT
- Repository
- github.com/LumiRx/num-mcp
- Website
- itsnum.com/agents/
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from itsnum.com
Cite this page
NUM MCP server. Agent Mart. https://agentmart.dev/connectors/itsnum-com-num (last updated 2026-10-24)