✦ Anysphere · checked 2026-08-29

NUM in Cursor.

Cursor reads MCP servers from a JSON file — one for the project, one for you.

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 Cursor

.cursor/mcp.json (this project) or ~/.cursor/mcp.json (everywhere)

{
  "mcpServers": {
    "num": {
      "type": "http",
      "url": "https://itsnum.com/mcp",
      "headers": {
        "Authorization": "Bearer numa_live_..."
      }
    }
  }
}
  1. Create the file if it does not exist and paste the block above.
  2. Settings → MCP. The num server should appear with its five tools listed.
  3. If the toggle is off, turn it on — Cursor disables new servers until you approve them.

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 Cursor and checked against Anysphere'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