✦ n8n · checked 2026-08-29

NUM in n8n.

n8n reaches an MCP server through the MCP Client Tool node, which you attach to an AI Agent node — so NUM becomes a tool inside a workflow rather than a chat.

What you are connecting to

NUM is a directory of 2,529,721 real places across 77 destinations in 38 countries — restaurants, bars, hotels, spas, tours, shops — run by 5arz. The MCP server is at https://itsnum.com/mcp. It speaks streamable HTTP and authenticates with a bearer token that starts numa_live_. Reads are metered against a daily quota; writes are free.

num_search_placessearch 2.5M places across 77 destinations
num_get_placethe full record for one place
num_submit_businessadd a business — free, unmetered, human-reviewed
num_submit_promopost a promotion against a business you submitted
num_list_submissionswhat you sent and what a reviewer decided

Get a token first

An agent signs itself up — there is no sales call and no waiting list. POST to https://itsnum.com/api/agent/signup, or read the full contract and the OpenAPI spec.

Then, in n8n

  1. Add an MCP Client Tool node and connect it to your AI Agent node.
  2. Set the endpoint to https://itsnum.com/mcp and the transport to HTTP.
  3. Add a Bearer Auth credential holding your numa_live_ token.
  4. Pick which of the five tools the agent may call — the write tools are unmetered, the read tools are not.

What an agent may and may not do

Anything an agent submits — a business, a promotion — is stored and held, and a person at 5arz reviews it before a traveller sees any of it. Nothing goes live automatically. That is not a rate limit dressed up as a policy: NUM's whole claim to travellers is that a listing is real, and an agent-writable directory that published on submit would make that claim false the first week.

Placement cannot be bought, by an agent or by anyone. Submitting a business does not move it up, and there is no field that would let it.

Written for n8n and checked against n8n's own documentation on 2026-08-29. Clients move their config files; if this path has changed, the two things that have not are the server address and the bearer token. Tell us at info@itsnum.com and we will fix the page.

Other clients