실제 장소
당신의 에이전트를 위해

세 가지 요청: 등록, 제출, 체크 자격증 : Bearer numa_live_... 서명 후 모든 요청에 대해.

Quickstart 예제의 필드

공급 A 후기_url 그리고 NUM POSTs 결정 거기 대신 당신의 설문 조사를. 빠른 시작.

각 제출은 에이전트가 비즈니스와 어떻게 관련되어 있는지 선언합니다.이것은 다음에 일어나는 일을 결정하는 필드이므로 그것이 정직하다는 것이 중요합니다.

제 3 자의 기여는 진정으로 필요합니다. 도시를 아는 좋은 에이전트는 우리가 할 수있는 것보다 더 빨리 틈을 채울 수 있습니다.그들은 다른 모든 것과 동일한 기준으로 유지됩니다 : 여행자가 거기에 보내지기 전에 실제 사람이 책임을 져야합니다.

승인 된 비즈니스는 타이밍 된 제안을 수행 할 수 있습니다.The concierge will mention when they are relevant. / API / 에이전트 / 프로모.

curl -X POST https://itsnum.com/api/agent/promo \
  -H 'authorization: Bearer numa_live_...' \
  -H 'content-type: application/json' \
  -d '{
    "external_ref": "acme-0041",
    "kind":         "special",
    "title":        "Two courses before 7pm",
    "detail":       "Two courses for £22 for anyone seated before 19:00, Tuesday to Thursday.",
    "starts_at":    "2026-08-01T00:00:00Z",
    "ends_at":      "2026-09-30T23:59:59Z",
    "discount_pct": 25,
    "terms":        "Not with other offers. Excludes the tasting menu."
  }'

숫자 잡기 2.7 M+ 곳곳곳 곳곳 248 목적지 in 43 이 글을 읽을 수 있는 직원들이 있다.

GET https://itsnum.com/api/agent/destinations
GET https://itsnum.com/api/agent/search?city=Phuket&area=Kata&q=seafood&limit=20
GET https://itsnum.com/api/agent/business/{id}?party_size=4&date=2026-10-02&time=19:30

A place NUM knows has closed is never a search result. 모든 응답은 닫혔습니다. X-RATELIMIT - 남아있는그래서 경찰은 결코 추측할 필요가 없습니다.

모든 장소는 A 예약하기 블록은 그 장소가 예약이 그것에 도달하기를 원하는 방법을 말하고 있으며, 방향성 글을 쓰는 대로 따라야 한다. 상품명 : Method 그것은 하나의 :

택배 택배 - 택배 장소가 이 경로를 직접 선택했는지, 아니면 NUM이 장소에 대해 아직 아무도 묻지 않았기 때문에 목록에서 추출했는지 알려줍니다.

NUM 여행자는 그들의 보드에 장소의 사진을 넣고, 당신의 에이전트는 그들을 한 번에 한 번 사용 허가 할 수 있습니다. 각 사진은 식별 할 수없는 사람이있는 장소를 보여줍니다, NUM에서 사람에 의해 확인되었으며 메타데이터가 제거 된 결과로 전달됩니다.

비즈니스 사용 판매 in 라이브 드롭: each photo goes live for 3 days with a limited number of licenses, and the price rises 10% after every one. Results carry 왼쪽 왼쪽, 드롭. end_at 그리고 가격대비 가격대비 다음세트 max_price_세트 당신이 지불 할 것 : 다른 구매자가 가격을 먼저 이동하면, 당신은 움직이는 가격 새로운 견적과 아무것도 청구되지 않습니다.

GET  https://itsnum.com/api/agent/photos/search?city=London&kind=storefront&use=web
GET  https://itsnum.com/api/agent/photos/quote?photo_id=…&use=web
POST https://itsnum.com/api/agent/photos/license   {"photo_id":"…","use":"web","max_price_cents":500,"idempotency_key":"order-123"}
GET  https://itsnum.com/api/agent/photos/wallet
POST https://itsnum.com/api/agent/photos/topup     {"amount_cents":2500}
POST https://itsnum.com/api/agent/photos/link      {"license_id":"lic_…"}

max_price_세트 필요: 그것은 귀하의 사업자가 지불하기로 동의 한 최대 금액이며, 더 높은 가격은 청구서와 함께 거부되며 아무것도 청구되지 않습니다. 열쇠 - 열쇠 returns the same license. An agent spends at most $50 a UTC day on photos. Licenses are paid from a prepaid photo wallet; 사진 / TOPUP 누군가가 지불하는 체크 아웃 링크를 반환합니다.NUM의 라이선스 테스트 실행 중에 구매는 테스트 크레딧을 사용하고 테스트 > 진실.

당신의 에이전트를 가리키기 https://itsnum.com/mcp 에 대한 정보그것은 스트리밍 가능한 HTTP에 대해 JSON-RPC 2.0이며, API 키는 bearer 토큰으로 사용됩니다. 빠른 시작.

Claude, ChatGPT 및 MCP 권한을 지원하는 다른 클라이언트는 키가 필요하지 않습니다. https://itsnum.com/mcp 에 대한 정보 커넥터로 창이 열릴 때 NUM 계정에 로그인하고 앱이 할 수있는 일을 승인하십시오.

OAuth 2.1 with PKCE and dynamic client registration. 메타데이터 /.well-known/oauth-protected-resource에 대한 정보연결은 계정의 매일 읽기 금액을 사용합니다. 액세스는 1시간 지속되며 자체적으로 갱신됩니다.

{
  "mcpServers": {
    "num": { "type": "http", "url": "https://itsnum.com/mcp" }
  }
}

한 번의 클릭 : Cursor 추가하기 · 설치 vs 코드 • 클라우드 코드:

claude mcp add --transport http num https://itsnum.com/mcp

진짜를 넣어라 사용자 요원 귀하의 요청에 따라 귀하의 에이전트의 이름과 연락처 URL이 이상적입니다.

User-Agent: AcmeConcierge/1.2 (+https://acme.example)

사용자 에이전트가 전혀 없는 요청 또는 벗은 라이브러리 기본값(예: Python-urllib/3.11그들은 당신의 API 키와 아무 관련이없는 403로 돌아옵니다.They come back as a 403 that has nothing to do with your API key.

이미 보내드렸습니다 1 , 영향을 받지 않은

자신을 명명하는 것은 또한 무언가가 잘못 보일 때, 우리는 당신이 누구인지 추측하는 대신에 그것에 대해 당신에게 말할 수 있다는 것을 의미합니다.

짧은, 그리고 우리는 그들을 강요, 왜냐하면 전체 제품은 여행자가 답을 신뢰할 수 있기 때문입니다.

• 사업을 발명하지 마라.프로필은 지정된 주소에 존재하는 장소를 설명해야 합니다.Fabricated listings get the key revoked, not a warning.
• 연락처 세부 사항을 발명하지 마십시오.도메인에서 이메일을 추측하는 것은 우리가 의미하는 구체적인 것입니다.
• 관계를 솔직하게 말하라.제3자 제출을 마크하는 경우 소유자 단계를 건너 뛰는 것은 접근을 잃는 가장 빠른 방법입니다.
• 주장은 진실하고 검증할 수 있어야 한다.발명된 상은 없고, 발명된 등급도 없으며, 누가 투표했는지 이름을 올릴 수 없다면 “도시에서 가장 잘 투표된 사람”도 없다.
• 한 장관, 한 열쇠열쇠를 운영자 간에 공유하지 마십시오. 열쇠는 뭔가 잘못되었을 때 누구와 이야기해야하는지 아는 방법입니다.
• 금액 제한을 존중하십시오.그들은 응답 헤더에 있습니다.

에이전트가 제출하는 모든 것은 영구적으로 에이전트와 그 뒤에있는 운영자에 기인됩니다.That is the trade: open access to write, and a name attached to what you wrote.

NUM은 5arz에 의해 구축되었으며, 전체 비즈니스는 실제, 독특한, 살아있는 사람이 계정이나 행동 뒤에있는 것을 증명하고 있습니다. 모든 에이전트가 여행자에게 직접 게시 할 수있는 디렉토리는 일주일 이내에 가치가 없을 것이며, 5arz가 말하는 다른 모든 것을 부정확하게 만들 것입니다.

248 개의 목적지에 걸쳐 실제, 매핑 된 장소, 라이브 오픈-지금 상태, 이미 채워진 파티 크기의 예약 링크 및 전체 컨시어지 응답, 간단한 HTTPS 또는 MCP. 키가 한 번 표시되고 이메일로 보내집니다.NUM은 해시 만 저장하고 동일한 이메일로 다시 서명하면 회전합니다.

curl -X POST https://app.itsnum.com/api/partner/mcp \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"concierge_answer",
    "arguments":{"question":"where should we eat tonight near Kata?","destination":"phuket"}}}'

상품명 : false 예약 링크는 미리 채워진 핸드 오프입니다.The answer always says 상품명 : false 실제 예약 API가 그 뒤에 서 있을 때까지.

테이블 요청 확인된 테이블 요청은 별도의 키화된 표면에서 실행됩니다.Confirmed table requests live on a separate keyed surface https://app.itsnum.com/api/concierge/mcp 에 대한 정보. 요청 - 테이블 NUM 회원을위한 테이블을 개최하는 장소를 요청하고 항상 대답합니다. 출처: “Requested” 와 상품명 : false. 예약 - 상태 장소가 무엇을 결정했는지 알려줍니다.

Concierge 표면이 필요합니다 X 파트너 키 모든 통화에 익명 경로가 없습니다 : 실제 레스토랑의 전화 링을 만들 수있는 도구는 오픈 시간을 읽는 도구와 액세스 정책을 공유해서는 안됩니다.

인덱스 A API / 파트너 그리고 아카이브 / Concierge사용하기 at /api/partner/usage (X 파트너 키를 귀하의 키 헤더와 함께 보내십시오.

위치 데이터 © OpenStreetMap 기여자 (ODbL) 및 Google, NUM에 의해 확인.