How to Use the Dime.Scheduler MCP in Pydantic AI

Build bulletproof dispatch workflows with Pydantic AI and type-safe Dime.Scheduler validation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dime.Scheduler MCP to Pydantic AI

Create your Vinkius account to connect Dime.Scheduler 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 Dime.Scheduler with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate ERP payloads at runtime using this MCP Server

Type-safe schedule inspection relies on the `list_appointments`, `list_tasks`, and `list_resources` tools. Pydantic AI validates every incoming ERP payload against strict Python models before your agent can act on it. If your ERP schema changes or returns unexpected null values, the framework raises a validation error immediately. This prevents your agent from making decisions based on malformed or corrupted scheduling data.

Parse job categories with zero silent failures

The validation engine parses data returned by the `get_job`, `list_jobs`, and `list_categories` tools. Every job ID, category code, and status field is checked against your defined Pydantic schemas. This MCP Server guarantees that your agent receives clean, predictable data structures. You avoid runtime errors caused by missing fields, ensuring your automated scheduling pipelines run reliably in production.

Map time markers safely in Pydantic AI

Visual scheduling states are retrieved using the `list_time_markers` tool to map timeline indicators. The agent uses these validated markers to track job progress and technician availability. Because Pydantic AI is model-agnostic, you can swap your underlying LLM provider at any time. The validation layer remains identical, protecting your scheduling logic from model-specific parsing quirks.

Setup guide

Set up Dime.Scheduler 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": {
        "dimescheduler-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Dime.Scheduler 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 Dime.Scheduler. 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 Dime.Scheduler 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 Dime.Scheduler MCP in Pydantic AI

Install the slim package with the MCP extra, then instantiate the unified toolset class with your Vinkius HTTP URL. Pass the toolset directly into your agent's toolset list.

It protects your agent from silent failures. If the ERP returns unexpected data types, the framework catches it at the boundary, preventing your agent from hallucinating schedule details.

Yes, you can connect using either streamable HTTP or SSE transports. The Vinkius platform handles the underlying connection protocol, exposing a clean endpoint for your Pydantic AI agent.

Yes, you can define custom schemas matching your ERP's specific metadata fields. Pydantic AI will enforce those types at runtime, raising errors if the fields do not match your layout.

All scheduling records, task assignments, and resource details are processed in memory within the Vinkius MCP Server sandbox. The platform acts as a secure, ephemeral bridge, never storing your ERP credentials or operational data.

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