Lugares Reales
para su agente.

Tres solicitudes: inscribirse, enviar, comprobar. Autorización: Conductor numa_live_... en cada solicitud después de la firma.

Campos en el ejemplo Quickstart

suministro a Conexión_url y NUM POSTs la decisión allí en lugar de hacer una encuesta. la solicitud completa está en el Quickstart.

Cada presentación declara cómo el agente está relacionado con el negocio.Este es el campo que decide lo que sucede a continuación, por lo que importa que sea honesto.

Las contribuciones de terceros son verdaderamente deseadas.Un buen agente que conoce una ciudad puede llenar las lagunas más rápido de lo que podemos.Se mantienen al mismo estándar que todo lo demás: una persona real es responsable de ello antes de que un viajero sea enviado allí.

Una empresa aprobada puede llevar ofertas a tiempo que el concierge mencionará cuando sean relevantes. /Api / Agente / Promoción.

curl -X POST https://itsnum.com/api/agent/promo \
  -H 'authorization: Bearer numa_live_...' \
  -H 'content-type: application/json' \
  -d '{
    "external_ref": "acme-0041",
    "kind":         "special",
    "title":        "Two courses before 7pm",
    "detail":       "Two courses for £22 for anyone seated before 19:00, Tuesday to Thursday.",
    "starts_at":    "2026-08-01T00:00:00Z",
    "ends_at":      "2026-09-30T23:59:59Z",
    "discount_pct": 25,
    "terms":        "Not with other offers. Excludes the tasting menu."
  }'

Número de mantienen 2.7 M+ Lugares a través 248 Destinos en 43 Los agentes pueden leer esto.

GET https://itsnum.com/api/agent/destinations
GET https://itsnum.com/api/agent/search?city=Phuket&area=Kata&q=seafood&limit=20
GET https://itsnum.com/api/agent/business/{id}?party_size=4&date=2026-10-02&time=19:30

Un lugar que NUM sabe que está cerrado nunca es un resultado de búsqueda. X-Ratelimit-RestanteAsí que un agente nunca tiene que adivinar.

Cada lugar lleva a Reserva bloque que dice cómo ese lugar quiere que las reservas lo lleguen, y un Guía la sentencia a seguir como se escribe. Reserva.Método Es uno de:

booking.chosen_by_venue es el le dice si el lugar eligió esta ruta por sí mismo, o si NUM la derivó de la lista porque nadie ha preguntado al lugar todavía.

Los viajeros de NUM colocan sus fotos de lugares en sus tableros, y su agente puede licenciarlos un uso a la vez. Cada foto muestra un lugar sin persona reconocible, fue revisada por una persona en NUM, y se entrega con sus metadatos extraídos. Los resultados llevan un lugar, una ciudad y un mes, nunca coordenadas o una fecha exacta.

El negocio utiliza la venta en Drops en vivo: each photo goes live for 3 days with a limited number of licenses, and the price rises 10% after every one. Results carry de la izquierda, Siguiente → Finales → y Precio - PróximoEl set max_precio centavos a lo que va a pagar: si otro comprador mueve el precio por encima de él primero, obtendrá Precio movido con la nueva cita y nada es cargado.

GET  https://itsnum.com/api/agent/photos/search?city=London&kind=storefront&use=web
GET  https://itsnum.com/api/agent/photos/quote?photo_id=…&use=web
POST https://itsnum.com/api/agent/photos/license   {"photo_id":"…","use":"web","max_price_cents":500,"idempotency_key":"order-123"}
GET  https://itsnum.com/api/agent/photos/wallet
POST https://itsnum.com/api/agent/photos/topup     {"amount_cents":2500}
POST https://itsnum.com/api/agent/photos/link      {"license_id":"lic_…"}

max_precio centavos se requiere: es el máximo que su operador ha acordado pagar, y un precio más alto se rechaza con la cotización, sin cobrar nada. Potencialidad_key returns the same license. An agent spends at most $50 a UTC day on photos. Licenses are paid from a prepaid photo wallet; Imágenes / Topup Devuelve un enlace de checkout que una persona paga. Durante la prueba de licencia de NUM, las compras usan el crédito de prueba y dicen: “Test” es verdad.

Poner a su agente en HTTPS://itsnum.com/mcpEs JSON-RPC 2.0 sobre HTTP streaming, con la clave de la API como un token portador. Quickstart.

Claude, ChatGPT y otros clientes que soportan la autorización de MCP no necesitan una clave. HTTPS://itsnum.com/mcp como un conector, inicie sesión en su cuenta NUM cuando se abra la ventana y apruebe lo que la aplicación puede hacer.

OAuth 2.1 con PKCE y registro dinámico de clientes. /.conocido / oauth-protected-recursoLa conexión utiliza la cuota de lectura diaria de su cuenta. El acceso dura una hora y se renueva por sí mismo.

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

Un solo clic: Añadir el cursor · Instalación VS Código El código de Claude:

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

Poner un real Usuario Agente El nombre de su agente y una URL de contacto es ideal:

User-Agent: AcmeConcierge/1.2 (+https://acme.example)

Solicitudes sin Agente de Usuario en absoluto, o un estándar de biblioteca desnuda, como Python-urllib/3.11, son desviados en el borde de la red antes de llegar a NUM. Se vuelven como un 403 que no tiene nada que ver con su clave API.

Ya envió uno, no afectado

Nombrearse también significa que cuando algo parece mal en nuestro final, podemos decirle acerca de ello en lugar de adivinar quién eres.

Breve, y las aplicamos, porque todo el producto se basa en que un viajero pueda confiar en una respuesta.

• No inventes un negocio.Un perfil debe describir un lugar que existe en la dirección dada.Listas fabricadas reciben la clave revocada, no una advertencia.
• No inventes los detalles de contacto.Adivinar un correo electrónico de un dominio es lo específico que queremos decir.Enviar el campo vacío en lugar de adivinar.
• Declara la relación honestamente.Marcar una presentación de terceros como propietario Saltar un paso es la forma más rápida de perder el acceso.
• Las afirmaciones deben ser verdaderas y verificables.No hay premios inventados, no hay calificaciones inventadas, no hay "mejor votado en la ciudad" a menos que puedas nombrar quién votó.
• Un agente, una llaveNo comparta una clave entre operadores.La clave es cómo sabemos a quién hablar cuando algo está mal.
• Respetar los límites de tasa.Están en las cabezas de respuesta.

Todo lo que un agente envía se atribuye al agente y al operador detrás de él, permanentemente.Este es el comercio: acceso abierto a escribir, y un nombre adjunto a lo que escribiste.

NUM es construido por 5arz, cuyo negocio entero está demostrando que una persona real, única y viva está detrás de una cuenta o una acción. Un directorio que permita a cualquier agente publicar directamente a los viajeros sería inútil dentro de una semana, y haría que todo lo demás 5arz dice no sea cierto.

Lugares reales, mapeados en 248 destinos, estado abierto en vivo, enlaces de reserva con el tamaño de la fiesta ya cumplimentado y respuestas de concierge completas, sobre HTTPS o MCP. La clave se muestra una vez y se le envía un correo electrónico.

curl -X POST https://app.itsnum.com/api/partner/mcp \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"concierge_answer",
    "arguments":{"question":"where should we eat tonight near Kata?","destination":"phuket"}}}'

Título: Falso Los enlaces de reserva son préstamos.La respuesta siempre dice Título: Falso hasta que una API de reserva real esté detrás de ella.

Solicitud de mesa. Las solicitudes de tabla confirmadas viven en una superficie clave separada, HTTPS://app.itsnum.com/api/concierge/mcp. Solicitud - Mesa pide a un lugar que mantenga una mesa para un miembro de NUM y siempre responde Estado de “requerido” con Título: Falso. Reserva - Estatus Te contamos lo que decidió el lugar.

La superficie del concierto necesita un La clave de X-Partner No hay un camino anónimo: una herramienta que pueda hacer el anillo telefónico de un restaurante real no debe compartir una política de acceso con una que lee las horas de apertura.

Los índices en / API / Socio y Ayuntamiento / ConciergeUso en /api/partner/usage (enviar su clave X-Partner) con el encabezado de la clave.

Los datos de ubicación © OpenStreetMap contributors (ODbL) y Google, verificados por NUM. La atribución viaja con cada carga útil y debe mostrarse.