fitDEGREE MCP by usefulapi
Read locations, classes, sessions, bookings, members, sales and staff in fitDEGREE.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (8)
🟢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
Evidence