NUM MCP 서버

여행 장소를 위한 원격 MCP 서버. 2,529,721개 장소의 디렉토리를 검색하고, 38개국 77개 목적지를 대상으로 하며, 업체나 프로모션을 사람의 검토를 위해 제출할 수 있습니다.

5arz Inc. 운영 · 엔드포인트: https://itsnum.com/mcp · 공식 MCP 레지스트리에 com.itsnum/num으로 등록됨.

이 저장소는 문서, 연결 설정 및 클라이언트 예제를 보관합니다. 서버 자체는 호스팅됩니다 — 설치하거나 실행할 것이 없습니다.

빠른 시작

도구 검색은 공개되어 있습니다. 자격 증명 없이도 서버가 제공하는 기능을 확인할 수 있습니다:

curl -sS -X POST https://itsnum.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

도구를 호출하려면 무료 API 키가 필요합니다:

curl -sS -X POST https://itsnum.com/api/agent/signup \
  -H 'content-type: application/json' \
  -d '{
        "agent_name": "Acme Listings Bot",
        "operator_name": "Acme Ltd",
        "operator_email": "ops@acme.example",
        "purpose": "Suggest restaurants and bars to travellers in Thailand."
      }'

키는 한 번만 반환되며 복구할 수 없습니다. 즉시 저장하세요. POST /api/agent/me/rotate에서 교체하고, GET /api/agent/me에서 사용량을 확인하세요.

위 모든 내용의 실행 가능한 버전은 examples/에 있습니다.

Related MCP server: discava – Business Directory for AI

연결

전송: Streamable HTTP. 인증: Authorization: Bearer numa_live_…

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

{
  "mcpServers": {
    "num": {
      "url": "https://itsnum.com/mcp",
      "headers": { "Authorization": "Bearer numa_live_YOUR_KEY" }
    }
  }
}

{
  "servers": {
    "num": {
      "type": "http",
      "url": "https://itsnum.com/mcp",
      "headers": { "Authorization": "Bearer ${input:num_key}" }
    }
  },
  "inputs": [
    { "id": "num_key", "type": "promptString", "description": "NUM API key", "password": true }
  ]
}

도구

다섯 가지 모두 MCP 도구 주석(readOnlyHint, destructiveHint, openWorldHint)을 포함하므로, 클라이언트는 어떤 도구가 읽기 전용이고 어떤 도구가 쓰기인지 알 수 있습니다.

할당량 — 일일 읽기: 무료 100 · 번들 2,000 · 프로 20,000 · 풀 200,000. 쓰기는 무료 등급을 포함한 모든 등급에서 무제한입니다. 우리는 여러분의 돈보다 데이터를 원합니다.

구축하기 전에 이해해야 할 두 가지

제출물은 자동으로 게시되지 않습니다. num_submit_business 또는 num_submit_promo를 통해 전송된 모든 것은 저장되지만, 5arz의 사람이 승인할 때까지 여행자에게 보이지 않습니다. 이는 의도적인 것이며, 건너뛸 수 있는 대기열이 아닙니다. 도구가 성공을 반환했다고 사용자에게 리스팅이 게시되었다고 말하지 마세요 — 검토자의 결정을 위해 num_list_submissions를 폴링하세요.

"인증됨"은 여기서 특정한 의미를 가지며, 리뷰 점수가 아닙니다. NUM에서 인증됨은 사람 또는 클레임된 리스팅을 설명합니다 — 장소가 아닙니다:

• 인증된 게스트는 5arz가 고유한 실제 인간임을 확인한 여행자입니다.

• 인증된 리스팅은 소유자가 이미 게시된 연락처 정보에 대한 통제권을 증명한 리스팅입니다.

• 클레임되지 않은 리스팅은 매핑되었을 뿐, 인증되지 않았습니다.

최종 사용자에게 NUM 데이터를 표시하는 경우, "인증됨"을 품질, 평점 또는 보증 신호로 렌더링하지 마십시오. 이는 이 사람은 실제 사람입니다 또는 이 소유자는 실제입니다를 의미할 뿐 — 음식이 맛있는지 여부와는 아무 관련이 없습니다.

관계를 정직하게 선언하세요

num_submit_business는 업체와의 관계를 묻고, 그 값이 중요합니다:

더 신뢰할 수 있어 보이기 위해 owner로 추측하는 것은 에이전트 키가 취소되는 가장 빠른 방법입니다. 연락처 정보를 절대 허위로 작성하지 마세요 — 연결할 수 없는 전화번호는 빈 필드보다 더 나쁩니다.

속도 제한 및 에티켓

• 읽기는 등급별로 일일 할당량이 적용되며, 쓰기는 할당량이 없습니다.

• 가입은 주소당 하루 5개의 키로 제한됩니다. 에이전트당 하나의 키면 충분합니다 — 재사용하세요.

• 429는 제한에 도달했음을 의미합니다. 백오프하세요; 빡빡한 루프에서 재시도하지 마세요.

검색 표면

가격

여행자에게는 무료이며, 여행자 예약 수수료는 없습니다. 업체는 무료로 등록하고 **NUM이 완료한 예약의 10%**를 자체 부담으로 지불하며, 여행자 청구서에 추가되지 않습니다. 방문 고객, 업체의 기존 단골 고객에 대해서는 수수료가 없으며, 월 최소 금액도 없습니다. 자세한 내용은 itsnum.com/pricing에서 확인하세요.

지원

• 질문, 버그, 파트너십: info@5arz.com

• 보안: SECURITY.md 참조

• 이 저장소의 문서 및 클라이언트 예제 문제에 대한 이슈는 환영합니다.

라이선스

이 저장소의 문서 및 예제: MIT. NUM 서비스, 그 데이터 및 디렉토리 자체는 5arz Inc.의 소유이며 이 저장소에 의해 라이선스되지 않습니다.