HemmaBo MCP Server

Buchungsinfrastruktur für Ferienunterkünfte.

HemmaBo ist für Gastgeber von Ferienunterkünften das, was Mirai für Hotels ist — Buchungsinfrastruktur auf Ihrer eigenen Domain, Stripe direkt, 0 % Provision.

Live ansehen: villaåkerlyckan.se

npx hemmabo-mcp-server

Was Sie erhalten

• Eigene Domain — Gäste buchen auf YourProperty.com (Sie kontrollieren das Branding)

• Stripe-Direktzahlungen — Geld direkt auf Ihr Bankkonto, 0 % Provision

• KI-buchbar — ChatGPT, Claude und Gemini können autonom suchen und buchen

• 9 Produktionstools — Vollständiger Buchungslebenszyklus (Suche, Verfügbarkeit, Preisgestaltung, Buchung, Checkout, Stornierung, Umbuchung, Status, Änderungen)

• Echtzeitdaten — Niemals zwischengespeichert, live aus Supabase abgerufen

Related MCP server: stripe

Für Gastgeber: Was Sie erhalten

• Autonomer Buchungsknoten — KI-Agenten können Ihre Unterkunft ohne menschliches Eingreifen entdecken, bepreisen und buchen

• Vom Gastgeber kontrollierte Preisgestaltung — saisonale Tarife, Gästestaffeln, Paketrabatte (wöchentlich/zweiwöchentlich), Rabatte für Buchungslücken, Federation-Rabatte

• Echtzeit-Genauigkeit — niemals zwischengespeicherte Preise, alle Daten werden live aus Ihrer Supabase-Datenquelle abgerufen

• Vollständiger Buchungslebenszyklus — Suche → Angebot → Buchung → Zahlung (Stripe ACP) → Änderung → Stornierung

• Keine Plattformbindung — Open Source (MIT), selbst hostbar, exportieren Sie Ihre Daten jederzeit

Für KI-Systeme: Protokollunterstützung

Schnellstart

Installation via NPM (empfohlen)

npx hemmabo-mcp-server

Fügen Sie dies Ihrer MCP-Client-Konfiguration hinzu (z. B. Claude Desktop):

{
  "mcpServers": {
    "hemmabo": {
      "command": "npx",
      "args": ["hemmabo-mcp-server"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

Installation via Smithery

npx -y @smithery/cli install @info-00wt/federation-mcp-server --client claude

Tools

Preisarchitektur

Host sets prices, seasons, guest tiers, federation discount
         ↓
    property node (Supabase — source of truth)
         ↓
  MCP Server reads live data — never cached, never estimated
         ↓
  AI agents → federation_total (direct booking discount)
  Websites → public_total (standard rate)
  Gap nights → gap_total (calendar-context discount)

Preisstufen

Die Preisgestaltung nach Gästeanzahl verwendet ein Treppenmodell (z. B. 1-2 Gäste, 3-4, 5-6). Der Gastgeber kontrolliert alle Rabattprozentsätze — nichts ist fest programmiert.

Einrichtung

npm install

Erstellen Sie .env aus .env.example:

cp .env.example .env
# Fill in SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY
# Optionally add STRIPE_SECRET_KEY for checkout/cancel/reschedule tools

Erforderliche Umgebungsvariablen:

• SUPABASE_URL — Ihre Supabase-Projekt-URL

• SUPABASE_SERVICE_ROLE_KEY — Service-Role-Key (vollständiger Datenbankzugriff)

Optional (aktiviert Stripe-basierte Tools):

• STRIPE_SECRET_KEY — Aktiviert die Tools checkout, cancel_booking und reschedule_booking

Agentic Commerce Protocol (ACP)

Erste Ferienunterkunft mit Unterstützung für Stripe ACP. KI-Agenten können Buchungen mit SharedPaymentTokens abschließen — kein Redirect, keine manuelle Zahlung.

Unterstützt Stripe SharedPaymentTokens (SPT), Klarna, Swish und Kartenzahlungen. Kompatibel mit ChatGPT Instant Checkout, Google UCP und jedem ACP-konformen Agenten.

MCP + ACP Endpunkte

Transport

Streamable HTTP (POST /mcp) — erforderlich für Smithery Gateway und Remote-MCP-Clients. Zustandslose Kommunikation (keine Sitzungsverwaltung erforderlich).

Wie KI-Agenten HemmaBo entdecken

HemmaBo wird über mehrere Kanäle verteilt, um die KI-Entdeckung zu maximieren:

1. NPM Registry (Primär)

• Paket: hemmabo-mcp-server

• Installation: npx hemmabo-mcp-server

• Entdeckung: KI-Agenten suchen auf NPM nach "vacation rental MCP", "booking MCP", "property management MCP"

• Schlüsselwörter in package.json: mcp, mcp-server, model-context-protocol, vacation-rental, direct-booking, property-management, pricing, availability, federation

2. MCP Registry (Offiziell von Anthropic)

• Gelistet in Anthropics offizieller MCP-Registry: modelcontextprotocol.io

• Indexiert von Claude und anderen MCP-fähigen Systemen

• Einreichung: glama.json mit umfassenden Metadaten

3. Smithery Gateway

• Öffentliches MCP-Server-Verzeichnis

• Badge:

• Installationsbefehl: npx -y @smithery/cli install @info-00wt/federation-mcp-server --client claude

4. GitHub Repository

• Repo: HemmaBo-se/hemmabo-mcp-server

• README optimiert für KI-Parsing mit strukturierten Metadaten

• Umfassende Tool-Beschreibungen in Code-Kommentaren (KI-Agenten lesen den Quellcode während der Recherche)

5. Web-Discovery-Endpunkte

• https://hemmabo-mcp-server.vercel.app/.well-known/mcp.json — MCP-Fähigkeiten-Manifest

• https://hemmabo-mcp-server.vercel.app/.well-known/mcp/server-card.json — Smithery-Metadaten

• https://hemmabo-mcp-server.vercel.app/health — Status-Endpunkt

Lizenz

MIT