NUM

NUM MCP サーバー

エージェントのための、本物の場所。 旅行向けのリモート MCP サーバーです。レストラン、バー、ホテル、スパ、ツアー、ショップなど、250 万件以上の場所が掲載されたディレクトリを検索できます。特にタイと英国の情報が充実しています。また、店舗やプロモーションを送信し、人による審査を受けることもできます。

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

Claude と ChatGPT： カスタムコネクターとして https://itsnum.com/mcp を追加し、NUM にサインインして承認します。キーは不要です。

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"}'

ツールを呼び出すには、サインインが必要です。方法は 2 つあり、どちらも共通の利用枠を使用します。

1. サインイン（OAuth 2.1）— Claude、ChatGPT、Cursor、VS Code、および MCP 認可に対応するすべてのクライアント。 クライアントには URL だけを渡します。最初のツール呼び出し時に NUM のサインイン画面が開き、num.read（検索）と num.write（送信）を承認します。PKCE と動的クライアント登録に対応しており、メタデータは https://itsnum.com/.well-known/oauth-protected-resource にあります。アクセスは 1 時間有効で、自動的に更新されます。クライアントからいつでも接続を解除できます。

2. 無料の API キー — スクリプト、サーバー、OAuth に対応していないクライアント向け：

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": "[email protected]",
        "purpose": "Suggest restaurants and bars to travellers in Thailand."
      }'

キーは一度だけ返され、再取得できません。すぐに保存してください。 POST /api/agent/me/rotate でローテーションし、GET /api/agent/me で使用状況を確認できます。

上記のすべてを実行できるバージョンは、examples/ にあります。

接続

トランスポート： Streamable HTTP。認証： OAuth 2.1、または Authorization: Bearer numa_live_…。 OAuth を使う場合は、以下の設定から headers ブロックを削除してください。

{
  "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 }
  ]
}

接続後に尋ねること

• プーケットのパトンで、電話番号が掲載されているタイ料理レストランを 3 軒探してください。
• エディンバラにはどのようなスパが掲載されていますか？ 最初のスパの全記録を表示してください。
• バンコクのルーフトップバーのうち、NUM のディレクトリに掲載されているものはどれですか？ また、オーナーが登録済みの店舗はどれですか？
• プーケットのカタでカフェを経営しています。オーナーとして NUM に登録してください。詳細はこちらです：…
• NUM に送信したものと、審査担当者の判断をすべて表示してください。

ツール

5つすべてにtitleとMCP ツールアノテーションが設定されています。読み取りツール3つにはreadOnlyHintが設定されています。 送信ツール2つにはdestructiveHintが設定されています。同じexternal_refまたは promo_refを再送信すると保留中の送信内容が上書きされるため、適切に動作するクライアントは事前に本人へ確認します。

クォータ — 1日あたりの読み取り回数： free 100 · bundle 2,000 · pro 20,000 · full 200,000。 すべてのプランで書き込みは無制限で、freeも対象です。私たちは、皆さんのお金よりもデータを得たいと考えています。

構築前に知っておきたい2つのこと

送信内容は自動的には公開されません。 num_submit_businessまたはnum_submit_promoを通じて 送信された内容はすべて保存されますが、5arzの担当者が承認するまで旅行者には表示されません。 これは意図的な仕様であり、順番を飛ばすことはできません。ツールが成功を返したからといって、掲載内容が公開されたとユーザーに伝えないでください。 num_list_submissionsを定期的に呼び出し、レビュアーの判断を確認してください。

ここでの「認証済み」には明確な意味があり、レビュー評価ではありません。 NUMでは、 認証済みは人または所有者確認済みの掲載情報を指し、場所を指すことはありません。

• 認証済みの旅行者とは、5arzが実在する固有の人間であると確認した旅行者です。
• 認証済みの掲載情報とは、所有者が、掲載情報にすでに公開されている連絡先を管理していることを証明したものです。
• 所有者未確認の掲載情報は地図に登録されていますが、認証済みではありません。

NUMのデータをエンドユーザーに表示する場合、「認証済み」を品質、評価、推薦のシグナルとして表示しないでください。これは実在する人物である、またはこの所有者は実在することを示すだけで、料理がおいしいかどうかを示すものではありません。

関係性を正確に申告する

num_submit_businessでは、ビジネスとの関係を指定する必要があり、その値は重要です。

信頼性を高く見せるためにownerと偽るのは、エージェントキーを無効にされる最も早い方法です。 連絡先を捏造しないでください。つながらない電話番号は、空欄よりも問題です。

レート制限とマナー

• 読み取りはプランごとに1日あたりの回数が制限されます。書き込みには制限がありません。
• 1つの住所につき、登録できるキーは1日5個までです。エージェント1つにつきキーは1つで十分です。使い回してください。
• 429は制限に達したことを意味します。待ってから再試行し、短い間隔で繰り返し再試行しないでください。

検出用エンドポイント

料金

APIとMCP サーバーは無料です。1日あたりの読み取りは100回、送信は無制限です。読み取り回数の多いプランは、月額$9.99から、ビジネスダッシュボードと同じプランで利用できます。

旅行者は無料で利用でき、旅行者向けの予約手数料もありません。ビジネスは無料で掲載でき、NUMが予約を成立させた場合にのみ、ビジネス側が**テーブル予約で10％、客室予約で15％、アクティビティ予約で20％**を支払います。旅行者の請求額に上乗せされることはありません。無断キャンセルや予約の辞退には費用がかかりません。詳細はitsnum.com/pricingをご覧ください。

サポート

• ご質問、バグ、提携について：[email protected]
• プライバシーポリシー · 利用規約
• セキュリティについては、SECURITY.mdをご覧ください
• ドキュメントやクライアントのサンプルに関する問題は、このリポジトリで報告してください。

ライセンス

このリポジトリのドキュメントとサンプル：MIT。 NUM サービス、そのデータ、およびディレクトリ自体は5arz Inc.の専有物であり、 このリポジトリによってライセンスされるものではありません。