How to Use the ExerciseDB MCP in Mastra AI

Q: How can I search for exercises using ExerciseDB with Mastra AI agents?

You define a tool call to getexercisesbyname within your agent configuration. The agent then executes this against the ExerciseDB server.

Q: Can I use ExerciseDB to validate muscle targets in a Mastra AI workflow?

Absolutely. Use gettargetlist to fetch the valid muscle set. Your agent compares the user's input against this list to prevent invalid queries.

Q: How do I ensure the agent only uses specific equipment from ExerciseDB?

You restrict the agent's tool access by filtering the getexercisesbyequipment parameters. This limits the agent's output to your preferred gear.

Build complex, fault-tolerant fitness workflows in Mastra AI using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ExerciseDB MCP to Mastra AI

Create your Vinkius account to connect ExerciseDB to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ExerciseDB with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated fitness chains for Mastra AI

Create multi-step routines by chaining `get_body_part_list` and `get_exercises_by_body_part` inside your Mastra agents. The workflow engine handles the execution flow automatically. Define clear failure paths if a specific exercise lookup fails. Your agent can retry the fetch using `get_exercise_by_id` to ensure the final workout plan is complete.

Conditional exercise logic in Mastra AI

Use `get_equipment_list` as the source of truth for your agent's conditional branching. If the user lacks specific gear, the agent skips those tools in the workflow. Implement retries for the `get_exercises_by_equipment` call to account for intermittent network issues. This keeps your agent's operation stable during long-running tasks.

Structured exercise discovery in Mastra AI

Map the output of `get_target_list` into your agent's internal memory. This allows the system to make informed decisions about which muscles to target in a training cycle. Use `get_exercises_by_name` to verify user requests against the database. Your agent gains the ability to confirm if an exercise exists before adding it to a routine.

Setup guide

Set up ExerciseDB MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All ExerciseDB tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "exercisedb-mcp-client",
  servers: {
    "exercisedb-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "ExerciseDB Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to ExerciseDB tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent ExerciseDB transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ExerciseDB. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ExerciseDB now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ExerciseDB MCP in Mastra AI

You define a tool call to `get_exercises_by_name` within your agent configuration. The agent then executes this against the ExerciseDB server.

Yes. Mastra supports automatic retries for any tool call, including those made to this MCP Server. You configure the backoff strategy in your agent definition.

Absolutely. Use `get_target_list` to fetch the valid muscle set. Your agent compares the user's input against this list to prevent invalid queries.

You restrict the agent's tool access by filtering the `get_exercises_by_equipment` parameters. This limits the agent's output to your preferred gear.

The server transmits only public exercise metadata. No sensitive user health data or private credentials are ever processed by this integration.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python