Servidor MCP NUM

Un servidor MCP remoto para lugares de viaje. Busca en un directorio de 2.529.721 lugares en 77 destinos de 38 países, y envía negocios o promociones para revisión humana.

Operado por 5arz Inc. · Endpoint: https://itsnum.com/mcp · Listado en el Registro oficial de MCP como com.itsnum/num.

Este repositorio contiene la documentación, configuraciones de conexión y ejemplos de clientes. El servidor está alojado — no hay nada que instalar ni ejecutar.

Inicio rápido

El descubrimiento de herramientas está abierto. Puedes ver lo que ofrece el servidor sin ninguna credencial:

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

Llamar a una herramienta necesita una clave API gratuita:

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

La clave se devuelve una vez y no se puede recuperar. Guárdala inmediatamente. Rota en POST /api/agent/me/rotate; consulta tu uso en GET /api/agent/me.

Las versiones ejecutables de todo lo anterior están en examples/.

Related MCP server: discava – Business Directory for AI

Conexión

Transporte: HTTP Streamable. Autenticación: 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 }
  ]
}

Herramientas

Las cinco llevan anotaciones de herramientas MCP (readOnlyHint, destructiveHint, openWorldHint), para que un cliente pueda distinguir qué herramientas solo leen y cuáles escriben.

Cuotas — lecturas por día: gratis 100 · paquete 2.000 · pro 20.000 · completo 200.000. Las escrituras son ilimitadas en todos los niveles, incluido el gratuito. Preferimos tener tus datos que tu dinero.

Dos cosas que vale la pena entender antes de construir

Los envíos no se publican automáticamente. Todo lo enviado a través de num_submit_business o num_submit_promo se almacena pero permanece invisible para los viajeros hasta que un humano en 5arz lo apruebe. Esto es deliberado y no es una cola que puedas saltar. No le digas a un usuario que su listado está activo porque la herramienta devolvió éxito — consulta num_list_submissions para conocer la decisión del revisor.

**