fitDEGREE MCP by usefulapi

Read locations, classes, sessions, bookings, members, sales and staff in fitDEGREE.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
83%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,449Tokens (tool definitions)
~2.9 KBTypical response size
Moderate attention impact (1.91% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "fitdegree": {
      "url": "https://fitdegree.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://fitdegree.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (8)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢fitdegree_get_account

Return the fitDEGREE account behind the API key: type (fitspot or company), identifier and label. Good first call to check the connection. API: GET /v1/me.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_fitspots(ids, company_id, updated_after, updated_before, order, ...)

List the studio locations (fitspots) the key can see: id, name, company. Use the ids in the other list tools. API: GET /v1/fitspots.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "company_id": {
      "description": "Only fitspots of this company id.",
      "type": "string"
    },
    "updated_after": {
      "description": "Only fitspots updated at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "updated_before": {
      "description": "Only fitspots updated at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order": {
      "description": "Sort direction of last_updated_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_classes(ids, group_id, updated_after, updated_before, order, ...)

List the classes (the studio's class definitions, for example a yoga or spin class) with their class group. API: GET /v1/classes.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "group_id": {
      "description": "Only classes of this class group id.",
      "type": "string"
    },
    "updated_after": {
      "description": "Only classes updated at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "updated_before": {
      "description": "Only classes updated at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order": {
      "description": "Sort direction of last_updated_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_registrables(ids, fitspot_id, class_id, is_cancelled, starts_after, ...)

List the bookable sessions (registrables): one scheduled class at a studio, with start and end time, cancellation flag and class id. Use it for the schedule and for free spots. API: GET /v1/registrables.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "fitspot_id": {
      "description": "Only sessions at this fitspot id.",
      "type": "string"
    },
    "class_id": {
      "description": "Only sessions of this class id.",
      "type": "string"
    },
    "is_cancelled": {
      "description": "true = cancelled sessions only; false = active sessions only.",
      "type": "boolean"
    },
    "starts_after": {
      "description": "Only sessions starting at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "starts_before": {
      "description": "Only sessions starting at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "ends_after": {
      "description": "Only sessions ending at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "ends_before": {
      "description": "Only sessions ending at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order_by_start": {
      "description": "Sort by start_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_registrations(ids, user_ids, registrable_ids, status, updated_after, ...)

List the bookings (registrations): which member is booked on which bookable session, and the status. Cursor pagination is available: pass next_cursor back as cursor. API: GET /v1/registrations.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "user_ids": {
      "description": "Only bookings of these member ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "registrable_ids": {
      "description": "Only bookings on these session ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "status": {
      "description": "Only bookings with this status (as the API defines it).",
      "type": "string"
    },
    "updated_after": {
      "description": "Only bookings updated at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "updated_before": {
      "description": "Only bookings updated at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "created_after": {
      "description": "Only bookings created at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "created_before": {
      "description": "Only bookings created at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order": {
      "description": "Sort direction of last_updated_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "description": "next_cursor of the previous page. Send an empty string for the first cursor page; omit it to page by page number.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_users(ids, fitspot_id, updated_after, updated_before, order, ...)

List the studio's members (users): name and contact fields as the API returns them, and their fitspot. Cursor pagination is available: pass next_cursor back as cursor. API: GET /v1/users.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "fitspot_id": {
      "description": "Only members of this fitspot id.",
      "type": "string"
    },
    "updated_after": {
      "description": "Only members updated at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "updated_before": {
      "description": "Only members updated at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order": {
      "description": "Sort direction of last_updated_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "description": "next_cursor of the previous page. Send an empty string for the first cursor page; omit it to page by page number.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_sales(ids, user_ids, updated_after, updated_before, order, ...)

List the sales (purchases of memberships, passes or other items) with the member they belong to. Cursor pagination is available: pass next_cursor back as cursor. API: GET /v1/sales.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "user_ids": {
      "description": "Only sales of these member ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "updated_after": {
      "description": "Only sales updated at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "updated_before": {
      "description": "Only sales updated at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order": {
      "description": "Sort direction of last_updated_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "description": "next_cursor of the previous page. Send an empty string for the first cursor page; omit it to page by page number.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢fitdegree_list_team_members(ids, fitspot_id, is_active, updated_after, updated_before, ...)

List the studio's staff (team members): name, role fields and whether they are active. Use it to match instructors to sessions. API: GET /v1/team_members.

Input Schema

{
  "type": "object",
  "properties": {
    "ids": {
      "description": "Only these ids (max 100).",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "fitspot_id": {
      "description": "Only staff of this fitspot id.",
      "type": "string"
    },
    "is_active": {
      "description": "true = active staff only; false = inactive staff only.",
      "type": "boolean"
    },
    "updated_after": {
      "description": "Only staff updated at or after this datetime.",
      "type": "string",
      "minLength": 1
    },
    "updated_before": {
      "description": "Only staff updated at or before this datetime.",
      "type": "string",
      "minLength": 1
    },
    "order": {
      "description": "Sort direction of last_updated_datetime.",
      "type": "string",
      "enum": [
        "ASC",
        "DESC"
      ]
    },
    "page": {
      "description": "Page number for offset pagination (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools