smatch-mcp-public

Public read-only MCP server for smatch padel clubs. Designed for WhatsApp agents and public-facing bots.

Tools

| Tool | Type | Description | |------|------|-------------| | get_club_info | read | Club name, location, contact, schedules, social media | | get_courts | read | List courts with pricing rates | | get_court_availability | read | Available time slots for a date | | get_club_schedule | read | Daily agenda: matches + reservations | | get_club_tournaments | read | Club tournaments (excludes drafts) | | get_tournament_details | read | Tournament info with categories | | get_tournament_bracket | read | Bracket/draw with player names and scores | | get_tournament_matches | read | Tournament matches with results | | request_reservation | write | Request a court reservation (status: created, source: whatsapp) |

Setup

npm install -g smatch-mcp-public

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | SMATCH_MONGODB_URI | yes | MongoDB connection string | | SMATCH_CLUB_ID | yes | Club ObjectId to scope all queries |

Run

SMATCH_MONGODB_URI=mongodb://... SMATCH_CLUB_ID=abc123 smatch-mcp-public

Claude Desktop / MCP config

{
  "mcpServers": {
    "smatch-public": {
      "command": "npx",
      "args": ["-y", "smatch-mcp-public"],
      "env": {
        "SMATCH_MONGODB_URI": "mongodb://...",
        "SMATCH_CLUB_ID": "abc123"
      }
    }
  }
}

Reservation flow

request_reservation creates a reservation with:

• status: "created" (pending club approval)
• source: "whatsapp"
• Automatic conflict detection
• Rate lookup based on court, day, and time

The club sees the reservation in their dashboard and confirms or rejects it.

Related

• smatch-mcp — Admin MCP server (full CRUD, staff management, backups)