Echte Orte
für Ihren Agent.

Drei Anfragen: Anmelden, Einreichen, Überprüfen Autorisierung: Bearer numa_live_... Auf jeden Antrag nach der Unterschrift.

Feld im Quickstart-Beispiel

Versorgung a Rücksendung_url und NUM POSTs die Entscheidung dort, anstatt Sie Umfrage zu machen. QuickStart.

Jede Einreichung erklärt, wie der Agent mit dem Geschäft zusammenhängt.Dies ist das Feld, das entscheidet, was als nächstes passiert, also ist es wichtig, dass es ehrlich ist.

Ein guter Agent, der eine Stadt kennt, kann Lücken schneller füllen, als wir können.Sie werden nach dem gleichen Standard gehalten wie alles andere: Eine echte Person ist dafür verantwortlich, bevor ein Reisender dorthin geschickt wird.

Ein genehmigtes Unternehmen kann zeitgemäße Angebote mitbringen, die der Concierge erwähnen wird, wenn sie relevant sind. /API / Agent / Promo.

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

Anzahl hält 2.7 M+ Plätze über 248 Destinationen in 43 Länder.Agenten können das lesen.

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

Ein Ort, an dem NUM weiß, dass es geschlossen ist, ist nie ein Suchergebnis. x-ratelimit-rückbleibendEin Agent muss niemals erraten.

Jeder Ort trägt eine Buchung Block, der sagt, wie dieser Ort Buchungen erreichen möchte, und ein Leitung Satz folgen wie geschrieben. Buchung.Methode ist einer von:

Buchung.chosen_by_venue sagt Ihnen, ob der Veranstaltungsort diese Route selbst gewählt hat oder ob NUM sie aus der Auflistung abgeleitet hat, weil niemand den Veranstaltungsort noch gefragt hat.

NUM-Reisende legen ihre Fotos von Orten auf ihre Briefe, und Ihr Agent kann sie zu einer Zeit lizenzieren. Jedes Foto zeigt einen Ort ohne erkennbare Person, wurde von einer Person bei NUM überprüft und wird mit ihren Metadaten geliefert.

Business nutzt Verkauf in Die Live Drops: each photo goes live for 3 days with a limited number of licenses, and the price rises 10% after every one. Results carry Drop. links, Drop.ends auf und Drop.preis - NächstesSet Max_Preis für Cent zu dem, was Sie zahlen werden: Wenn ein anderer Käufer den Preis zuerst vorbei bewegt, erhalten Sie Preise bewegen Mit dem neuen Zitat und nichts aufgeladen.

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_Preis für Cent erforderlich ist: es ist der Höchstbetrag, den Ihr Betreiber zu zahlen vereinbart hat, und ein höherer Preis wird mit dem Angebot abgelehnt, ohne dass etwas berechnet wird. Schlüssel - Schlüssel returns the same license. An agent spends at most $50 a UTC day on photos. Licenses are paid from a prepaid photo wallet; Bilder / Topup gibt einen Checkout-Link zurück, den eine Person zahlt. Während der Lizenzprüfung von NUM verwenden Käufe Testkredite und sagen „Test“ – wahr.

Stellen Sie Ihren Agent an HTTPS://itsnum.com/mcp im InternetEs ist JSON-RPC 2.0 über Streaming HTTP, mit dem API-Schlüssel als Träger-Token. QuickStart.

Claude, ChatGPT und andere Clients, die MCP-Authentifizierung unterstützen, benötigen keinen Schlüssel. HTTPS://itsnum.com/mcp im Internet Als Connector melden Sie sich beim Öffnen des Fensters bei Ihrem NUM-Konto an und genehmigen Sie, was die App tun kann.

OAuth 2.1 mit PKCE und dynamischer Client-Registrierung. /.bekannter/auch geschützter RessourceDie Verbindung nutzt die tägliche Lesezeit Ihres Kontos.Der Zugriff dauert eine Stunde und erneuert sich von selbst.

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

Mit einem Klick: Zu Cursor hinzufügen · Installieren von VS Code Der Claude Code:

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

Setzen Sie ein echtes Benutzeragent Name Ihres Agenten und eine Kontakt-URL sind ideal:

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

Anfragen ohne User-Agent überhaupt oder eine bloße Bibliothek Standard, wie z. B. Python-urllib/3.11Sie kommen als 403 zurück, der nichts mit Ihrem API-Schlüssel zu tun hat.

Bereits 1 geschickt, unberührt

Sich selbst zu benennen bedeutet auch, dass, wenn etwas am Ende falsch aussieht, wir Ihnen darüber erzählen können, anstatt zu erraten, wer Sie sind.

Kurz, und wir erzwingen sie, weil das gesamte Produkt auf einem Reisenden beruht, der einer Antwort vertrauen kann.

• Erfinden Sie kein Geschäft.Ein Profil muss einen Ort beschreiben, der an der angegebenen Adresse existiert.
• Erfinden Sie keine Kontaktdaten.Eine E-Mail von einer Domain zu erraten, ist das spezifische, was wir meinen.Senden Sie das Feld leer anstatt erraten.
• Erklären Sie die Beziehung ehrlich.Markieren einer Drittanbieter-Einreichung als Eigentümer Ein Schritt zu überspringen ist der schnellste Weg, den Zugang zu verlieren.
• Behauptungen müssen wahr und überprüfbar sein.Keine erfundenen Auszeichnungen, keine erfundenen Bewertungen, keine „beste Stimme in der Stadt“, es sei denn, Sie können benennen, wer gestimmt hat.
• Ein Agent, ein SchlüsselTeilen Sie keinen Schlüssel zwischen den Betreibern, der Schlüssel ist, wie wir wissen, mit wem wir sprechen können, wenn etwas nicht stimmt.
• Einhaltung der Zinsgrenzen.Sie befinden sich in den Reaktionsschlagzeilen.

Alles, was ein Agent übermittelt, wird dem Agent und dem Betreiber dahinter dauerhaft zugeschrieben.Das ist der Handel: offener Zugang zum Schreiben und ein Name, der dem, was Sie geschrieben haben, beigefügt ist.

NUM wird von 5arz gebaut, dessen gesamtes Geschäft beweist, dass eine echte, einzigartige, lebende Person hinter einem Konto oder einer Aktion steckt. Ein Verzeichnis, das es jedem Agenten erlaubt, direkt an Reisende zu veröffentlichen, wäre innerhalb einer Woche wertlos, und es würde alles andere 5arz sagt unwahr machen.

Echte, gemappte Orte über 248 Ziele, Live-Open-Now-Status, Buchungslinks mit der bereits ausgefüllten Partygröße und vollständige Concierge-Antworten, über einfache HTTPS oder MCP. Der Schlüssel wird einmal angezeigt und an Sie gesendet.

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

Schlagwort: Falsch Buchung Links sind vorgefüllte Hand-offs. Die Antwort sagt immer Schlagwort: Falsch bis eine echte Reservierungs-API dahinter steht.

Tisch für Anfragen. Bestätigte Tabellenanfragen leben auf einer separaten Schlüsseloberfläche, HTTPS://app.itsnum.com/api/concierge/mcp. Anfrage - Tisch bittet einen Veranstaltungsort, einen Tisch für ein NUM-Mitglied zu halten und antwortet immer Status: „anfordert“ mit Schlagwort: Falsch. Buchung - Status Er erzählt, was der Ort entschieden hat.

Die Concierge-Oberfläche benötigt eine X-Partner Schlüssel Es gibt keinen anonymen Weg: Ein Tool, das den Telefonring eines echten Restaurants machen kann, sollte keine Zugangsrichtlinie mit einem, der Öffnungszeiten liest, teilen.

Indizes bei / API / Partner und / API / ConciergeDie Verwendung bei /api/partner/usage (Senden Sie Ihren X-Partner-Key) mit Ihrem Schlüsselheader.

Platzdaten © OpenStreetMap contributors (ODbL) und Google, überprüft von NUM. Attribution reist mit jeder Nutzlast und muss angezeigt werden.