Massimino MCP server

Fitness data for your AI assistant

Add one URL to Claude or ChatGPT and it can look up exercises, read full training programmes and compare how active European countries are, straight from Massimino. No sign-up, no key.

https://massimino.fitness/api/mcp

Connect

Three ways in

  • Claude

    1. 1Open Settings, then Connectors.
    2. 2Choose "Add custom connector".
    3. 3Name it Massimino and paste the URL.
    4. 4Leave the OAuth fields empty and connect.

    In Claude Code, one command does it:

    claude mcp add --transport http massimino https://massimino.fitness/api/mcp
  • ChatGPT

    1. 1Open Settings, then Apps and Connectors.
    2. 2Under Advanced, turn on Developer mode.
    3. 3Create a connector, name it Massimino and paste the URL.
    4. 4Set authentication to "No authentication" and create.

    Custom connectors need a paid ChatGPT plan. Search and fetch also work in deep research.

  • Other assistants

    1. 1Any client with Streamable HTTP transport works.
    2. 2Give it the URL; no header is needed.
    3. 3Cursor, VS Code, Gemini CLI and Mistral use a JSON or TOML entry with this URL.
    4. 4The server is stateless and answers in JSON.

    A minimal entry for a JSON configuration file:

    { "mcpServers": { "massimino": { "url": "https://massimino.fitness/api/mcp" } } }

Then ask something real, for example: "Use Massimino to build me a beginner leg workout with dumbbells."

With your account

Add your own workout log

Use this URL instead of the first one. It serves the same open data, plus the sets and sessions you logged, so you can ask "how did my squat go this month?"

https://massimino.fitness/api/mcp/me
  1. 1Add the URL in the same place as above. In ChatGPT, choose OAuth as the authentication.
  2. 2Your assistant opens a Massimino window. Sign in as you normally do.
  3. 3Massimino shows which app is asking and what it will read. Choose Allow.
  4. 4To end it, open the API page: the connection is in your key list, with a Revoke button.

What the assistant gets

8 tools

search
Search Massimino's open fitness data: exercises, training programmes, public teams and Eurostat physical-activity figures by country. Returns ids to pass to fetch. Use short keyword queries such as "squat", "hiit" or "Sweden".
fetch
Get the full text of one record by an id returned from search: an exercise with its instructions, a programme with all its workouts, a team, or a country's figures.
find_exercises
Find exercises with step-by-step instructions, filtered by any of: text in the name, muscle group, equipment, difficulty. Use this to build or explain a workout. All exercises are public-domain.
list_programs
List Massimino's open training programmes (HIIT, balance, flexibility, cardio, plyometrics, periodised strength, programmes for new parents and for people short of time) with level, length and sessions per week.
get_program
Get one training programme in full: every workout in order, with exercises, sets, repetitions and rest. Use an identifier from list_programs.
list_teams
List the public training teams on Massimino that people can join, with their description and how many places are left. No member or contact details.
get_country_fitness_data
Eurostat figures for one European country: the share of adults meeting the WHO physical-activity guideline, and employment in sport, each with the EU27 value for comparison.
get_my_workout_logNeeds your sign-in
The workout log of the person who signed in (or whose API key is connected): the sets they logged (date, exercise, repetitions, weight) and their recent sessions. Personal data, read-only.

How it behaves

Four things to know

01

No key needed

About 300 requests a minute, counted per address. Assistant apps share addresses, so signing in or using a free key gets you an allowance of your own.

02

Read-only

Every tool only reads. Nothing an assistant does here can change Massimino or your account.

03

The same open data

The tools serve exactly what the open API serves, with the same licences. Never members, emails or contact details.

04

Your own log, if you choose

The second URL adds one tool that reads the workout log of the account you sign in with, and nobody else's. You approve it once and can end it at any time.

Clients configured by file can send an API key as an Authorization: Bearer header on either URL. The first URL also accepts ?key= for apps that take nothing but a URL; a key in a URL can end up in logs and history, so prefer signing in, and revoke the key on the API page when you are done. This is general fitness information, not medical advice.