# PRactical Fitness Tracker

> PRactical is a strength-training app for serious lifters. Its core value proposition is 2-tap set completion — minimal phone time between sets while providing intelligent progress tracking.

## MCP API

PRactical exposes a Model Context Protocol (MCP) server at `POST https://practicalworkouts.com/mcp` that lets AI assistants read and write your workout data.

### Authentication
All MCP requests require an API key in the Authorization header:
```
Authorization: Bearer <your-64-char-hex-key>
```
Generate keys in the PRactical app under Settings → MCP Access (Premium feature).
Each key is a 64-character lowercase hex string generated on your device.

### Available Tools

- **list_workouts** — List recent workouts (name, date, volume, exercises)
- **get_workout** — Get full detail of a single workout including all sets
- **list_exercises** — Browse the exercise library, optionally filtered by muscle group
- **get_personal_records** — Get all personal records grouped by exercise
- **get_volume_trends** — Weekly training volume by muscle group for the last N weeks
- **get_training_stats** — Summary statistics: total workouts, sets this week, PRs, consistency
- **create_template** — Save a new workout template by name and exercise list

### Protocol
JSON-RPC 2.0 over HTTP POST. Protocol version: 2024-11-05.

## Setup Guides

First, generate an API key in the PRactical app: Settings → MCP Access → Generate API Key. Copy it immediately — it is shown only once.

### Claude (Pro / Max — easiest)
1. In Claude, go to **Customize → Connectors**
2. Click **+** → **Add custom connector**
3. Enter server URL: `https://practicalworkouts.com/mcp`
4. Click **Advanced settings** → set OAuth Client Secret to your API key
5. Click **Add**

Claude will discover all tools automatically. No config file editing required.

### Cursor / Windsurf / VS Code (MCP extension)
Add this to your MCP config:
```json
{
  "mcpServers": {
    "practical": {
      "url": "https://practicalworkouts.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}
```

### ChatGPT (Custom GPT Action)
In your Custom GPT Actions schema, add a POST action with:
- URL: `https://practicalworkouts.com/mcp`
- Authentication: API Key, header name `Authorization`, value `Bearer <your-key>`

## Website
https://practicalworkouts.com

## Support
https://practicalworkouts.com/help