_ registry / mcp streamable-http · checked 1h ago

num

https://itsnum.com

Registry code: 2303fd24a547ff50

api record

NUM is a travel places directory run by 5arz. 'Verified' on NUM refers to identity-checked guests and owner-claimed listings, not to unclaimed places. Reads are metered per UTC day; writes are free. Every business or promotion submitted is reviewed by a person before a traveller sees it and returns status 'pending_review'. Submissions whose contact details were guessed — an email address derived from a domain name, for instance — are rejected in review. The full rules are at https://itsnum.com/agents/.

endpoint
https://itsnum.com/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is num live?
Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.
Is num free to use?
Partly — some of its tools are open, others need a key or payment.
What tools does num have?
10 tools: num_submit_promo, num_license_photo, num_submit_business, num_get_place, num_list_destinations, num_photo_wallet, num_search_photos, num_search_places, ….
Is num safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
147ms

last good check

priced tools
0

of 10 tools

_ answered our checks, 90 days 319 checks · signed record
  • down → live
  • unknown → live
_ what it is for
topic
maps travel & places places & venues
used for
  • search restaurants, bars and hotels in a destination
  • get how to book a place
  • submit a business for review
  • attach a promotion to a business
takes → gives
text → data
tools
4 reads2 changes data
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 10 tools
1 open5 auth-required 4 never probed 6 of 10 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • num_list_destinations reads open 6h ago

    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.

    mcp-tool

    {
  "type": "object",
  "properties": {}
}
    arguments 4 lines
  • num_photo_wallet auth-required 6h ago

    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.

    mcp-tool

    {
  "type": "object",
  "properties": {}
}
    arguments 4 lines
  • num_search_photos auth-required 6h ago

    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 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 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.

    mcp-tool

    {
  "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)."
    }
  }
}
    arguments 54 lines
  • num_search_places reads auth-required 16h ago

    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.

    mcp-tool

    {
  "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'."
    }
  }
}
    arguments 31 lines
  • num_quote_photo auth-required 12h ago

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 22 lines
  • num_list_submissions reads auth-required 16h ago

    Lists the businesses and promotions this account has submitted, with the reviewer's decision on each. Free and unmetered.

    mcp-tool

    {
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    },
    "status": {
      "enum": [
        "pending",
        "approved",
        "rejected",
        "duplicate",
        "withdrawn"
      ],
      "type": "string"
    }
  }
}
    arguments 24 lines
  • num_submit_promo changes data unknown never probed

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 51 lines
  • num_license_photo unknown never probed

    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 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 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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 32 lines
  • num_submit_business changes data unknown never probed

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 70 lines
  • num_get_place reads unknown 16h ago

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 26 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 2303fd24a547ff50.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/2303fd24a547ff50/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/2303fd24a547ff50/badge.svg)](https://brick.blue/agent/2303fd24a547ff50?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on itsnum.com 1 entry

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.