How to Use the ExerciseDB MCP in AutoGen

Q: How do I add ExerciseDB tools to an AutoGen agent?

Use the mcpservertools helper with your Vinkius HTTP endpoint. Pass the resulting tool list directly to the AssistantAgent constructor.

Q: Can AutoGen agents collaborate to filter ExerciseDB movements?

Yes, they can. One agent can query getexercisesbybodypart to get a broad list, and another can filter those results using getexercisesbyequipment to match user gear.

Build multi-agent AutoGen debates to design, review, and refine workout routines using the ExerciseDB library.

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 AutoGen

Create your Vinkius account to connect ExerciseDB to AutoGen 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 AutoGen

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run multi-agent debates on ExerciseDB workouts

Call `get_exercises_by_target` to build a high-intensity ExerciseDB routine, while an AutoGen safety agent reviews it. Set up a fitness coach agent and a safety agent in AutoGen to negotiate ExerciseDB workouts. The AutoGen safety agent can call `get_exercise_by_id` to inspect the step-by-step ExerciseDB instructions and secondary muscles. They debate until they agree on a balanced, safe AutoGen workout plan.

Map ExerciseDB tools to AutoGen agents automatically

Map `get_exercises_by_equipment` and other ExerciseDB tools automatically without writing boilerplate schema code in AutoGen. The `McpToolAdapter` converts all 9 ExerciseDB tools to match the expected AutoGen format. This lets you focus on multi-agent AutoGen conversation logic. Your AutoGen agents can immediately start querying `get_equipment_list` to negotiate which ExerciseDB gear is best for a home gym setup.

Build consensus-driven workout builders with this MCP Server

Query `get_exercises_by_name` to build complex AutoGen workflows where agents must agree on specific ExerciseDB movements. One AutoGen agent finds the exercises, while another checks `get_target_list` to make sure all ExerciseDB muscle groups are hit. This collaborative AutoGen approach ensures high-quality plans. The AutoGen agents coordinate their tool calls, passing results back and forth until they compile the final ExerciseDB workout routine.

Setup guide

Set up ExerciseDB MCP in AutoGen

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] package
Active Vinkius subscription with a valid endpoint token

1

Install AutoGen with MCP
Run pip install "autogen-ext[mcp]" autogen-agentchat. The MCP extension includes mcp_server_tools for stateless tool access.
2

Fetch tools from the MCP
Call mcp_server_tools(SseServerParams(url=...)) with your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Run your agent
Pass the tools to AssistantAgent and call agent.run(). The agent invokes ExerciseDB tools and returns structured results.

agent.py

from autogen_ext.tools.mcp import SseServerParams, mcp_server_tools
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

tools = await mcp_server_tools(server_params)

agent = AssistantAgent(
    name="ExerciseDB_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent ExerciseDB data")
print(result.messages[-1].content)

Get your connection token →

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] + autogen-agentchat
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Same packages as above. McpWorkbench is ideal when your agent needs stateful sessions across multiple tool calls.
2

Use McpWorkbench as context manager
Wrap your agent in async with McpWorkbench(...) to maintain shared state and resources. The workbench manages the full MCP session lifecycle.
3

Run with workbench
Pass workbench=workbench to your agent. State is preserved across multiple tool calls within the same session.

agent.py

from autogen_ext.tools.mcp import McpWorkbench, SseServerParams
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

async with McpWorkbench(server_params) as workbench:
    agent = AssistantAgent(
        name="ExerciseDB_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent ExerciseDB data")
    print(result.messages[-1].content)

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 AutoGen

Use the mcp_server_tools helper with your Vinkius HTTP endpoint. Pass the resulting tool list directly to the AssistantAgent constructor.

Yes, they can. One agent can query get_exercises_by_body_part to get a broad list, and another can filter those results using get_exercises_by_equipment to match user gear.

The McpToolAdapter automatically handles schema conversion. Your agents will always receive correctly formatted JSON payloads when calling tools like get_exercise_by_id.

It supports both stdio and Streamable HTTP transports. When using Vinkius, you connect using the secure Streamable HTTP parameter with your single token.

No one has access to your data. Vinkius processes all requests for exercise instructions and muscle targets in a zero-trust environment, using ephemeral sessions that leave absolutely zero data footprint behind.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript