# MallorcaBot

> Der persoenliche Local Guide fuer Mallorca. Discovery + Kuration + Insider-Wissen.
> Built by StudioMeyer. Matthias Meyer lebt seit 15 Jahren auf der Insel.

## About

- [Homepage](https://mallorcabot.de)
- [About](https://mallorcabot.de/de/ueber-uns) / [EN](https://mallorcabot.de/en/ueber-uns) / [ES](https://mallorcabot.de/es/ueber-uns)
- [Web chat](https://mallorcabot.de/de/chat)
- [Legal notice](https://mallorcabot.de/de/impressum)
- [Privacy](https://mallorcabot.de/de/datenschutz)

## Positioning

MallorcaBot is a travel chat assistant focused on Mallorca (Balearic Islands, Spain). It is NOT a weather app, NOT a flight tracker, NOT a Google Maps clone. The value is curated local knowledge by someone who has lived on the island for 15 years. Regions, seasons, villages, hidden beaches, local food, culture, hiking, nightlife beyond the tourist cliches.

## Channels (all share one core engine)

- **Web chat:** https://mallorcabot.de/de/chat  (stateless REST, messages array)
- **Chatbot widget:** floating button on every page, calls /api/chat/widget
- **Telegram:** @mallorcabot_bot (polling, per-user history)
- **MCP HTTP (SaaS):** https://mallorcabot.de/mcp (OAuth 2.1 + PKCE, Phase 1)
- **WhatsApp:** planned (Phase 2, waiting for Meta business verification)

## MCP Tools (Phase 0)

Currently one tool is live, more land as the content DB grows.

- `mb_guide`  —  Curated topic guide (first-visit, regions, when-to-visit, family, couples, foodies, nature, culture, nightlife, day-trips). DE/EN/ES. Static content, no fabrication.

Planned for Phase 1:
mb_search (semantic POI search via pgvector), mb_nearby, mb_beaches, mb_restaurants, mb_activities, mb_events, mb_transport, mb_emergency, mb_insider

## Languages

Deutsch, English, Espanol. The model answers in the language of the question. Full i18n on all web routes.

## Tech stack

Next.js 15 App Router + React 19 + TypeScript strict + Tailwind CSS 4
PostgreSQL 17 + pgvector 0.8.1 (shared `studiomeyer-postgres` container)
@modelcontextprotocol/sdk 1.12 (low-level Server, dual-mode stdio + HTTP)
@anthropic-ai/sdk 0.82  (Claude Haiku 4.5 for chat)
node-telegram-bot-api 0.67
Hosting: Alt-Dev 159.69.108.85, 3 Docker containers (app, bot, mcp)
CDN: Cloudflare (strict SSL, HTTP/3, Always HTTPS)

## How to hit the API

```bash
curl https://mallorcabot.de/api/chat/widget \
  -H 'content-type: application/json' \
  -d '{"message":"Welche Region ist im April am besten?"}'
```

## Honest Phase 0 disclaimer

As of April 2026 the curated database is still being built. The core engine returns general island knowledge accurately and will NEVER fabricate specific opening hours, phone numbers, or current prices. When asked for a fact it cannot verify, it says so plainly.

## Voice

No em-dashes. No markdown bold. No bullet-point lists with bold headers. Flowing prose like a friend who has lived on the island for 15 years. Honest when unsure. A deterministic post-processor (lib/core/voice.ts) strips any AI-assistant tics that slip through the system prompt.

## Contact

- Email: hello@mallorcabot.de (catch-all forwards to hello@studiomeyer.io)
- Parent: [StudioMeyer](https://studiomeyer.io), design + AI studio on Mallorca
- Founder: Matthias Meyer

## Repository

Private at this stage. Open questions about integration, partnership, or the MCP endpoint: hello@mallorcabot.de