NUM MCP サーバー

旅行先のためのリモートMCPサーバー。 38カ国77の目的地 にわたる 2,529,721件の場所 のディレクトリを検索し、人間によるレビューのためにビジネスやプロモーションを提出できます。

運営: 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."
      }'

キーは 1回だけ 返され、復元できません。すぐに保存してください。 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 }
  ]
}

ツール

5つすべてにMCPツールアノテーション（readOnlyHint、destructiveHint、openWorldHint）が含まれているため、クライアントはどのツールが読み取りのみで、どのツールが書き込みを行うかを判断できます。

クォータ — 1日あたりの読み取り回数: 無料100 · バンドル2,000 · プロ20,000 · フル200,000。 書き込みは無料を含むすべてのティアで無制限 です。私たちはあなたのお金よりもあなたのデータを重視します。

構築する前に理解すべき2つのこと

提出物は自動的に公開されません。 num_submit_business または num_submit_promo を通じて送信されたすべては保存されますが、5arzの人間が承認するまで旅行者には見えません。これは意図的なものであり、追い越せるキューではありません。ツールが成功を返したからといってユーザーに掲載が公開されたと伝えないでください — num_list_submissions をポーリングしてレビュアーの決定を確認してください。

「認証済み」はここで特定の意味を持ち、レビュースコアではありません。 NUMでは、認証済みは 人物 または 主張された掲載 を表します — 場所ではありません:

• 認証済みゲスト は、5arzが独自の実在の人間であると確認した旅行者です。

• 認証済み掲載 は、所有者がその掲載に既に公開されている連絡先詳細の管理を証明したものです。

• 主張されていない掲載はマッピングされており、認証されていません。

エンドユーザーにNUMデータを表示する場合、「認証済み」を品質、評価、または推奨のシグナルとしてレンダリングしないでください。これは これは実在の人物です または この所有者は実在します という意味であり、食べ物が美味しいかどうかについては何も述べていません。

関係性を正直に宣言する

num_submit_business は、ビジネスとの関係性を尋ね、その値は重要です:

見栄えを良くするために owner と推測することは、エージェントキーが取り消される最も早い方法です。連絡先詳細を決して偽装しないでください — 連絡のつかない電話番号は空白のフィールドよりも悪いです。

レート制限とエチケット

• 読み取りはティアごとに1日あたり従量制。書き込みは従量制ではありません。

• サインアップはアドレスごとに1日5キーに制限されています。エージェントあたり1キーで十分です — 再利用してください。

• 429 は制限に達したことを意味します。バックオフしてください。タイトループで再試行しないでください。

検出サーフェス

料金

旅行者は無料で、旅行者の予約手数料はありません。ビジネスは無料で掲載され、NUMが完了した予約の 10% をビジネス側から支払います。旅行者の請求書に追加されることはありません。飛び込み客、ビジネス自身のリピーター顧客には何もかからず、月額最低料金もありません。詳細は itsnum.com/pricing をご覧ください。

サポート

• 質問、バグ、パートナーシップ: info@5arz.com

• セキュリティ: SECURITY.md を参照

• このリポジトリへのイシューは、ドキュメントやクライアント例の問題について歓迎します。

ライセンス

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