MCP Server

TrainerStudio hosts an MCP (Model Context Protocol) server that lets AI assistants interact with your coaching data directly. No code required — just point your client to the server URL and start chatting.

https://api.trainerstudio.io/mcp

What is MCP?

Model Context Protocol is an open standard that lets AI assistants connect to external tools and data sources. Instead of writing API calls yourself, the AI handles everything through natural conversation.

With TrainerStudio's MCP server, you can say things like:

"Show me all my active clients"
"Create a leg day workout for María on Thursday"
"What exercises target the glutes?"

The AI translates your instructions into API calls automatically.

Prerequisites

You need a TrainerStudio API key. Go to Settings → API Keys in the coach app and create one. See Authentication for details.

Connect with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "trainerstudio": {
      "type": "url",
      "url": "https://api.trainerstudio.io/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop. You should see TrainerStudio listed as a connected tool.

Connect with Claude Code

Add the server to your project settings:

claude mcp add trainerstudio \
  --transport http \
  https://api.trainerstudio.io/mcp \
  --header "X-API-Key: your-api-key"

Or add it manually to .claude/settings.json:

{
  "mcpServers": {
    "trainerstudio": {
      "type": "url",
      "url": "https://api.trainerstudio.io/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Connect with ChatGPT

ChatGPT supports MCP connections in recent versions. Go to Settings → Connected Tools → Add MCP Server and enter:

URL: https://api.trainerstudio.io/mcp
Authentication: Header — X-API-Key: your-api-key

Connect with any MCP client

Any client that supports the MCP standard can connect using:

Setting	Value
Server URL	`https://api.trainerstudio.io/mcp`
Transport	HTTP (Streamable HTTP)
Auth header	`X-API-Key: your-api-key`

Available tools

Once connected, your AI assistant can use these tools:

Tool	Description
List clients	Get all your active clients
Create client	Add a new client with name and email
Get workouts	View programmed workouts for a client
Create workout	Program a workout block with exercises
List exercises	Browse the exercise library
Track metrics	Read and record body metrics

The full list of available tools is discovered automatically by your AI client when it connects — no manual configuration needed.

Example conversation

Once connected, a conversation might look like this:

You: How many active clients do I have?

AI: You have 47 active clients. Would you like to see the full list?

You: Create a push day for Carlos next Monday with bench press, overhead press, and lateral raises.

AI: Done! I created a "Push Day" workout for Carlos on Monday May 18th with 3 exercises: Bench Press, Overhead Press, and Lateral Raises. Each exercise has 3 sets programmed. Want me to adjust the sets or add more exercises?

Next steps

Authentication — create your API key
AI Agents — build custom agents with the REST API
API Reference — explore all available endpoints

MCP Server

On this page