GastroKalk MCP Server

Server Description

GastroKalk is a Swiss SaaS platform for the restaurant and hospitality industry (DACH region: Switzerland, Germany, Austria). Our MCP server exposes 159 tools that let AI assistants read, write, and automate across 28 restaurant management modules — from recipe costing and inventory to staff scheduling, POS, and supplier management.

The server implements JSON-RPC 2.0 over Streamable HTTP with full OAuth 2.1 authorization code flow (PKCE) and API key authentication. All 159 tools include safety annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint).

Features

Recipe & Food Cost Management

• Search, create, and update recipes with ingredient linking
• Calculate food cost per recipe and per portion
• Analyze food cost trends and detect anomalies
• Menu engineering analysis (Stars, Puzzles, Plowhorses, Dogs)
• Allergen detection across 14 EU main allergens

Inventory & Purchasing

• Track stock levels, detect expiring items (MHD/FIFO)
• Compare supplier prices across multiple vendors
• Generate shopping lists from inventory and recipes
• Create and send purchase orders to suppliers

Staff & Scheduling

• View and manage staff schedules with labor law compliance (L-GAV/ArbZG)
• Auto-plan weekly schedules based on demand forecasts
• Track working hours, overtime, and vacation balances

POS & Reservations

• Process orders, payments, and table management
• Manage reservations with guest profiles
• Daily revenue reports and X/Z reports

Financial & Analytics

• Cash book management with Swiss MwSt compliance
• Monthly P&L statements and profitability analysis
• Revenue forecasting with weather and holiday integration
• Multi-location comparison (Enterprise)

Setup Instructions

Option A: OAuth 2.0 (Claude.ai)

1. In Claude.ai, go to Settings → Integrations → Add MCP Server
2. Enter the server URL: https://mcp.gastrokalk.com/mcp
3. Click Connect — you will be redirected to GastroKalk for authorization
4. Log in with your GastroKalk account and grant the requested permissions
5. After authorization, Claude can access your restaurant data via MCP tools

Option B: API Key (Claude Desktop / Claude Code)

1. In GastroKalk, go to Einstellungen → Integrationen → KI-Verbindung (MCP)
2. Click "Neuen Schlüssel generieren" — copy the API key (shown once!)
3. Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "gastrokalk": {
      "type": "http",
      "url": "https://mcp.gastrokalk.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Authentication

OAuth 2.0 Authorization Code Flow

• Authorization Server Metadata: /.well-known/oauth-authorization-server
• Authorization Endpoint: /api/oauth/authorize
• Token Endpoint: /api/oauth/token
• Registration Endpoint: /api/oauth/register (Dynamic Client Registration)
• Scopes: read, write, delete

API Key Authentication

• Format: Authorization: Bearer mcp_live_...
• Generated per organization in the GastroKalk dashboard
• Keys can be revoked at any time

Rate Limits

Safety Annotations

Every tool includes MCP safety annotations, auto-derived from the tool's category and behavior:

Usage Examples

Privacy & Terms

• Privacy Policy: gastrokalk.com/datenschutz
• MCP Integration Privacy: gastrokalk.com/privacy-mcp
• Terms of Service: gastrokalk.com/terms
• MCP Terms: gastrokalk.com/terms-mcp

Data Handling

• All data is stored in Switzerland (Supabase EU region)
• Multi-tenant isolation: each organization sees only its own data
• OAuth tokens expire after 1 hour; API keys can be revoked instantly
• No conversation data is stored on GastroKalk's side
• Audit log tracks all tool executions (tool name, timestamp, success/error)

Support

Technical Reference

Supported MCP Methods

• initialize — Handshake with protocol version negotiation
• tools/list — Discover available tools (filtered by auth). Default: curated food-cost catalog; full catalog via OAuth scope tools:full
• tools/call — Execute a single tool (curated tools also return structuredContent)
• resources/list, resources/read, resources/templates/list — Recipes and supplier price lists
• prompts/list, prompts/get — Food-cost workflow prompts
• gastrokalk/batch — Execute up to 20 tools (GastroKalk extension; old name tools/batch is deprecated)
• gastrokalk/subscribe — Register webhooks for events (old name tools/subscribe is deprecated)
• ping — Health check

Webhook Events

14 event types available for real-time notifications:

• reservation.created, .updated, .cancelled
• order.created, .completed
• ingredient.price_changed, .low_stock
• pos.order_completed, .day_closed
• lieferschein.received, inventur.completed, checklist.completed
• lead.created, .status_changed

Error Handling

All errors follow JSON-RPC 2.0 error format with German-language messages:

• -32601 — Unknown tool or insufficient access
• -32602 — Invalid parameters
• -32000 — Rate limit / concurrency limit
• -32603 — Internal error (with reference ID for support)

Transient errors (timeouts, DB connection issues) include a retryable: true flag in the tool result. Clients should retry after 2–3 seconds.