How to Use the ExerciseDB MCP in Pydantic AI

Q: How do I install and configure the ExerciseDB MCP Server with Pydantic AI?

Run pip install "pydantic-ai-slimmcp" to install the framework with support. Use the unified MCPToolset class pointing to your Vinkius HTTP URL, and pass it to your Agent constructor.

Q: What is the deprecated way of connecting MCP servers in Pydantic AI?

You should avoid using MCPServerHTTP, which is now deprecated. Always use the unified MCPToolset helper to connect to your Vinkius-managed server.

Build type-safe fitness workflows with Pydantic AI and our ExerciseDB MCP Server to validate every exercise payload at runtime.

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 Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe validation with the ExerciseDB MCP Server

`get_exercise_by_id` returns a highly structured payload containing target muscles, secondary muscle groups, equipment, and step-by-step instructions. Pydantic AI validates this incoming data against strict Python schemas at runtime. If the API structure changes or returns unexpected nulls, your code catches it instantly. This strict validation prevents silent data corruption in your application. By using `MCPToolset` with your Vinkius HTTP endpoint, you ensure that every exercise name and GIF URL conforms exactly to your expected types before your agent processes them.

Dynamic anatomical discovery without hardcoding

`get_body_part_list` and `get_target_list` fetch the exact anatomical categories supported by the database. Instead of guessing whether the database uses "chest" or "pectorals", your agent queries these lists dynamically. It matches user queries to valid database keys with absolute precision. Because Pydantic AI is model-agnostic, you can use these tools with OpenAI, Anthropic, or local models. The framework handles the underlying validation layer, ensuring that whichever model you choose receives clean, structured JSON.

Precise filtering by equipment and target muscles

`get_exercises_by_equipment` and `get_exercises_by_target` let you build specialized workout generators. Your agent filters the 1,300+ exercise database down to specific routines based on what gear the user has. It eliminates the risk of the agent suggesting exercises with equipment that isn't available. The framework supports both Streamable HTTP and SSE transports. You run the server externally, and your Pydantic AI agent connects via a single endpoint token, keeping your deployment simple and secure.

Setup guide

Set up ExerciseDB MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "exercisedb-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to ExerciseDB tools.",
)

result = await agent.run("List recent ExerciseDB transactions")
print(result.output)

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 Pydantic AI

Run `pip install "pydantic-ai-slim[mcp]"` to install the framework with support. Use the unified `MCPToolset` class pointing to your Vinkius HTTP URL, and pass it to your `Agent` constructor.

Yes. The framework ensures that every field returned by tools like `get_exercises_by_name`, including the animated GIF URLs, matches the expected string and URL formats at runtime.

Yes. Pydantic AI is model-agnostic, meaning you can connect these exercise tools to local models or commercial APIs while maintaining strict runtime validation.

You should avoid using `MCPServerHTTP`, which is now deprecated. Always use the unified `MCPToolset` helper to connect to your Vinkius-managed server.

The server only handles public exercise definitions, body part lists, and equipment types. Your proprietary templates, user profiles, and active training plans never leave your local Pydantic AI runtime.

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