# A fitness MCP server your assistant can read and write

Endpoint: https://mcp.revns.com/mcp (Streamable HTTP, OAuth 2.1 with PKCE). Scopes: read:fitness, write:fitness, read:news.

## Connect

- [Claude](https://revns.com/mcp/claude.md): Add the MCP server as a custom connector in Claude (web, desktop or mobile) and sign in.
- [ChatGPT](https://revns.com/mcp/chatgpt.md): Create a custom connector in ChatGPT with the MCP endpoint, then approve the OAuth sign-in.
- [Claude Code](https://revns.com/mcp/claude-code.md): Run one command to add the server over HTTP, then authenticate from the /mcp menu.
- [Cursor](https://revns.com/mcp/cursor.md): Add the endpoint as a remote MCP server in Cursor's settings and sign in when prompted.

## Tools

| Tool | Permission | Does |
| --- | --- | --- |
| `get_today` | read | Brief, day score, pillar scores, what is logged and still open, meals and today's plan |
| `get_day` | read | The same view for any past date |
| `get_trends` | read | Daily values, means and previous-period comparison for chosen metrics |
| `get_weekly_review` | read | This week against last: score, consistency, best day, most missed |
| `get_week_plan` | read | The seven-day plan: sessions, effort, rest day, habits and protein anchors |
| `get_rank` | read | Your ranks for sleep, steps, training, heart rate and VO2 max against people your age, your sex or your kind of work, and what moves you up |
| `compare_with_athlete` | read | How you stack up against a typical footballer, cricketer, MMA fighter, F1 driver and more |
| `list_metrics` | read | Every tracked metric with its key, target, weight and cadence |
| `find_activities` | read | Search the master list of workouts and trackers, with calories at your weight |
| `list_goals` | read | Goals with pace, projection and status |
| `list_teams` | read | Teams and open invites |
| `get_team_board` | read | A team's shared scores, streaks and challenge standings |
| `quick_log` | write | Log from one line of text: "40 squats, slept 7h, lunch dal rice" |
| `log_entries` | write | Log values for one or more metrics |
| `log_meal` | write | Log a meal with On plan or Off plan and optional protein |
| `create_metric` | write | Start tracking anything new |
| `update_metric` | write | Change a target, weight, cadence or archive a metric |
| `set_profile` | write | Set up your whole profile in one call: objective, activities, trackers, weight, food, sex and kind of work |
| `set_goal` | write | Create a goal tied to a metric and date |
| `update_goal` | write | Change or close a goal |
| `plan_day` | write | Write the assistant's plan for a day |
| `apply_week_plan` | write | Write the seven-day plan into each day |
| `save_coach_note` | write | Write the morning brief or a weekly review |
| `get_health_news` | news | Recent health and fitness news |
| `search` | news | Search guides and news (OpenAI search contract) |
| `fetch` | news | Full text of a guide or story (OpenAI fetch contract) |

---

Canonical: https://revns.com/mcp
Index of everything: https://revns.com/llms.txt
revns gives training guidance, not medical advice.