puregym-mcp 0.2.0

PureGym Python client and MCP server for class discovery and booking management

PureGym MCP

puregym-mcp is a Python package and Model Context Protocol server for browsing PureGym centers in Denmark, discovering classes, checking your bookings, and managing bookings from MCP-compatible clients.

This is an independent third-party project and is not affiliated with, endorsed by, or sponsored by PureGym. PureGym is a registered trademark of Pure Gym Limited.

• Docs: puregym-mcp.jorgesintes.dev
• Public read-only endpoint: https://puregym-mcp.jorgesintes.dev/mcp
• PyPI: puregym-mcp

Capabilities

The server exposes a small set of tools for public class discovery and optional authenticated booking actions.

Class discovery

Available without PureGym credentials:

• get_capabilities
• list_class_types
• list_centers
• search_classes

Booking management

Available when PUREGYM_USERNAME and PUREGYM_PASSWORD are configured:

• list_my_bookings
• book_class
• cancel_booking
• get_center_live_status - Real-time occupancy and capacity data
• get_center_open_hours - Opening and staffed hours for a center

Modes

• Anonymous mode exposes read-only tools and uses a 14-day search window.
• Authenticated mode unlocks booking tools and expands the default search window to 28 days.

Quickstart

For most users, the easiest setup is local stdio usage from an MCP-compatible client:

{
  "mcp": {
    "puregym": {
      "enabled": true,
      "type": "local",
      "command": ["uvx", "puregym-mcp"],
      "environment": {
        "PUREGYM_USERNAME": "your-username",
        "PUREGYM_PASSWORD": "your-password"
      }
    }
  }
}

The environment block is optional and only needed for authenticated features.

Remote Deployment

The server supports both streamable-http and sse for remote MCP clients.

Public read-only hosting:

• Hosted endpoint: https://puregym-mcp.jorgesintes.dev/mcp
• Prefer anonymous mode for public deployments.

Security note:

• Do not expose a publicly reachable deployment configured with your personal PureGym credentials.
• Keep authenticated deployments private unless you have proper access control in front of them.

Example commands:

puregym-mcp --transport streamable-http --host 0.0.0.0 --port 8000 --streamable-http-path /mcp

puregym-mcp --transport sse --host 0.0.0.0 --port 8000 --sse-path /sse --message-path /messages/

Python Library

The package also exposes a reusable client and service layer:

from puregym_mcp import PureGymClient, PureGymService

client = PureGymClient()
service = PureGymService(client)

Docker

Build the image:

docker build -t puregym-mcp .

Run a public read-only server:

docker run --rm -p 8000:8000 puregym-mcp

Run a private authenticated server:

docker run --rm -p 8000:8000 \
  -e PUREGYM_USERNAME=your-email \
  -e PUREGYM_PASSWORD=your-password \
  puregym-mcp

Override the default container transport or path when needed:

docker run --rm -p 8000:8000 puregym-mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 8000 \
  --sse-path /sse

Development

Clone the repo and install dev dependencies:

uv sync --dev

Run from source:

uv run puregym-mcp --transport stdio

Run checks:

uv run pytest
uv run python -m compileall puregym_mcp tests
uv build

Test the built package locally before publishing:

uvx --from dist/puregym_mcp-0.2.0-py3-none-any.whl puregym-mcp --transport stdio

MCP Inspector

Launch the Inspector against this repo:

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/puregym-mcp \
  run \
  puregym-mcp --transport stdio

Launch it in authenticated mode:

npx @modelcontextprotocol/inspector \
  -e PUREGYM_USERNAME=your-email \
  -e PUREGYM_PASSWORD=your-password \
  -- \
  uv \
  --directory /path/to/puregym-mcp \
  run \
  puregym-mcp --transport stdio

The Inspector UI opens at http://localhost:6274.