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

连接

传输协议： 流式 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

• 欢迎针对此仓库中的文档和客户端示例问题提交 Issue。

许可证

此仓库中的文档和示例：MIT。 NUM 服务、其数据及目录本身归 5arz Inc. 所有， 不受此仓库许可。