Servidor MCP HemmaBo

Infraestructura de reservas para alquileres vacacionales.

HemmaBo es para los anfitriones de alquileres vacacionales lo que Mirai es para los hoteles: infraestructura de reservas en tu propio dominio, pago directo con Stripe, 0% de comisión.

Véalo en vivo: villaåkerlyckan.se

npx hemmabo-mcp-server

Qué obtienes

• Dominio propio — Los huéspedes reservan en TuPropiedad.com (tú controlas la marca)

• Pagos directos con Stripe — El dinero va a tu banco, 0% de comisión

• Reservable por IA — ChatGPT, Claude y Gemini pueden buscar y reservar de forma autónoma

• 9 herramientas de producción — Ciclo de vida completo de la reserva (búsqueda, disponibilidad, precios, reserva, pago, cancelación, reprogramación, estado, modificaciones)

• Datos en tiempo real — Nunca almacenados en caché, obtenidos directamente de Supabase

Related MCP server: stripe

Para anfitriones: Qué obtienes

• Nodo de reserva autónomo — Los agentes de IA pueden descubrir, fijar precios y reservar tu propiedad sin intervención humana

• Precios controlados por el anfitrión — tarifas estacionales, niveles según número de huéspedes, descuentos por paquetes (semanales/quincenales), descuentos por noches sueltas, descuentos de federación

• Precisión en tiempo real — precios nunca almacenados en caché, todos los datos se obtienen en vivo desde tu fuente de verdad en Supabase

• Ciclo de vida completo de la reserva — búsqueda → presupuesto → reserva → pago (Stripe ACP) → modificar → cancelar

• Sin dependencia de plataforma — código abierto (MIT), autohospedable, exporta tus datos en cualquier momento

Para sistemas de IA: Soporte de protocolo

Inicio rápido

Instalar vía NPM (recomendado)

npx hemmabo-mcp-server

Añadir a la configuración de tu cliente MCP (ej. 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"
      }
    }
  }
}

Instalar vía Smithery

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

Herramientas

Arquitectura de precios

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)

Niveles de precios

El precio según el número de huéspedes utiliza un modelo escalonado (ej. 1-2 huéspedes, 3-4, 5-6). El anfitrión controla todos los porcentajes de descuento; nada está codificado de forma rígida.

Configuración

npm install

Crea .env a partir de .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

Variables de entorno requeridas:

• SUPABASE_URL — La URL de tu proyecto Supabase

• SUPABASE_SERVICE_ROLE_KEY — Clave de rol de servicio (acceso completo a la base de datos)

Opcional (habilita herramientas potenciadas por Stripe):

• STRIPE_SECRET_KEY — Habilita las herramientas checkout, cancel_booking y reschedule_booking

Protocolo de Comercio Agéntico (ACP)

El primer alquiler vacacional con soporte para Stripe ACP. Los agentes de IA pueden completar reservas con SharedPaymentTokens: sin redirecciones, sin pagos manuales.

Soporta Stripe SharedPaymentTokens (SPT), Klarna, Swish y pagos con tarjeta. Compatible con ChatGPT Instant Checkout, Google UCP y cualquier agente compatible con ACP.

Endpoints MCP + ACP

Transporte

HTTP con streaming (POST /mcp) — requerido para Smithery Gateway y clientes MCP remotos. Sin estado (no se requiere gestión de sesiones).

Cómo descubren los agentes de IA a HemmaBo

HemmaBo se distribuye a través de múltiples canales para maximizar el descubrimiento por IA:

1. Registro NPM (Principal)

• Paquete: hemmabo-mcp-server

• Instalación: npx hemmabo-mcp-server

• Descubrimiento: Los agentes de IA buscan en NPM "vacation rental MCP", "booking MCP", "property management MCP"

• Palabras clave en package.json: mcp, mcp-server, model-context-protocol, vacation-rental, direct-booking, property-management, pricing, availability, federation

2. Registro MCP (Oficial de Anthropic)

• Listado en el registro oficial de MCP de Anthropic: modelcontextprotocol.io

• Indexado por Claude y otros sistemas compatibles con MCP

• Envío: glama.json con metadatos completos

3. Smithery Gateway

• Directorio público de servidores MCP

• Insignia:

• Comando de instalación: npx -y @smithery/cli install @info-00wt/federation-mcp-server --client claude

4. Repositorio de GitHub

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

• README optimizado para el análisis por IA con metadatos estructurados

• Descripciones completas de herramientas en comentarios del código (los agentes de IA leen el código fuente durante la investigación)

5. Endpoints de descubrimiento web

• https://hemmabo-mcp-server.vercel.app/.well-known/mcp.json — Manifiesto de capacidades MCP

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

• https://hemmabo-mcp-server.vercel.app/health — Endpoint de estado

Licencia

MIT