NUM MCP Server

Ein entfernter MCP-Server für Reiseorte. Durchsuchen Sie ein Verzeichnis von 2,529,721 Orten in 77 Zielgebieten in 38 Ländern und reichen Sie Unternehmen oder Werbeaktionen zur menschlichen Überprüfung ein.

Betrieben von 5arz Inc. · Endpunkt: https://itsnum.com/mcp · Gelistet im offiziellen MCP-Registry als com.itsnum/num.

Dieses Repository enthält die Dokumentation, Verbindungskonfigurationen und Client-Beispiele. Der Server selbst wird gehostet – es gibt nichts zu installieren oder auszuführen.

Quick start

Die Tool-Erkennung ist offen. Sie können sehen, was der Server bietet, ohne jegliche Anmeldeinformationen:

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

Das Aufrufen eines Tools erfordert einen kostenlosen API-Schlüssel:

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

Der Schlüssel wird einmalig zurückgegeben und ist nicht wiederherstellbar. Speichern Sie ihn sofort. Rotieren Sie ihn unter POST /api/agent/me/rotate; überprüfen Sie Ihre Nutzung unter GET /api/agent/me.

Ausführbare Versionen aller oben genannten befinden sich in examples/.

Related MCP server: discava – Business Directory for AI

Verbinden

Transport: Streamable HTTP. Auth: 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 }
  ]
}

Tools

Alle fünf tragen MCP-Tool-Annotationen (readOnlyHint, destructiveHint, openWorldHint), sodass ein Client erkennen kann, welche Tools nur lesen und welche schreiben.

Kontingente – Lesevorgänge pro Tag: kostenlos 100 · Bundle 2,000 · Pro 20,000 · Voll 200,000. Schreibvorgänge sind auf jeder Stufe unbegrenzt, einschließlich der kostenlosen. Wir hätten lieber Ihre Daten als Ihr Geld.

Zwei Dinge, die Sie verstehen sollten, bevor Sie etwas bauen

Einreichungen werden nicht automatisch veröffentlicht. Alles, was über num_submit_business oder num_submit_promo gesendet wird, wird gespeichert, bleibt aber für Reisende unsichtbar, bis ein Mensch bei 5arz es genehmigt. Dies ist beabsichtigt und keine Warteschlange, die Sie überspringen können. Sagen Sie einem Benutzer nicht, dass sein Eintrag live ist, weil das Tool Erfolg zurückgegeben hat – fragen Sie num_list_submissions nach der Entscheidung des Prüfers.

„Verifiziert“ hat hier eine spezifische Bedeutung und ist keine Bewertung. Bei NUM beschreibt verifiziert eine Person oder einen beanspruchten Eintrag – niemals einen Ort:

• Ein verifizierter Gast ist ein Reisender, von dem 5arz bestätigt hat, dass es sich um einen einzigartigen echten Menschen handelt.

• Ein verifizierter Eintrag ist einer, dessen Eigentümer die Kontrolle über die bereits veröffentlichten Kontaktdaten nachgewiesen hat.

• Nicht beanspruchte Einträge sind kartiert, nicht verifiziert.

Wenn Sie NUM-Daten für Endbenutzer anzeigen, stellen Sie „verifiziert“ bitte nicht als Qualitäts-, Bewertungs- oder Empfehlungssignal dar. Es sagt dies ist eine echte Person oder dieser Eigentümer ist echt – nichts darüber, ob das Essen gut ist.

Beziehungen ehrlich angeben

num_submit_business fragt nach Ihrer Beziehung zum Unternehmen, und der Wert ist wichtig:

Zu raten, dass Sie owner sind, um glaubwürdiger zu wirken, ist der schnellste Weg, einen Agentenschlüssel widerrufen zu lassen. Erfinden Sie niemals Kontaktdaten – eine nicht erreichbare Telefonnummer ist schlimmer als ein leeres Feld.

Ratenlimits und Etikette

• Lesevorgänge werden pro Tag nach Stufe abgerechnet; Schreibvorgänge werden nicht abgerechnet.

• Die Anmeldung ist auf 5 Schlüssel pro Adresse pro Tag begrenzt. Ein Schlüssel pro Agent ist ausreichend – verwenden Sie ihn wieder.

• 429 bedeutet, dass Sie ein Limit erreicht haben. Ziehen Sie sich zurück; wiederholen Sie es nicht in einer engen Schleife.

Entdeckungsoberflächen

Preise

Kostenlos für Reisende, und es gibt keine Buchungsgebühr für Reisende. Unternehmen listen kostenlos und zahlen 10% einer von NUM abgeschlossenen Buchung, aus ihrem Anteil, niemals der Rechnung des Reisenden hinzugefügt. Nichts für Laufkundschaft, nichts für eigene Stammkunden eines Unternehmens, kein monatliches Minimum. Alle Details unter itsnum.com/pricing.

Support

• Fragen, Fehler, Partnerschaft: info@5arz.com

• Sicherheit: siehe SECURITY.md

• Issues in diesem Repository sind für Dokumentations- und Client-Beispiel-Probleme willkommen.

Lizenz

Dokumentation und Beispiele in diesem Repository: MIT. Der NUM-Dienst, seine Daten und das Verzeichnis selbst sind Eigentum der 5arz Inc. und werden durch dieses Repository nicht lizenziert.