How to Use the BR Business Days Calculator MCP in Pydantic AI

Q: How do I set up BR Business Days Calculator in Pydantic AI?

Install the library with pip install "pydantic-ai-slimmcp". Use the MCPToolset class to connect to your Vinkius server URL, and pass it to your agent's toolsets parameter.

Get type-safe Brazilian calendar math in Pydantic AI with this deterministic 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 BR Business Days Calculator MCP to Pydantic AI

Create your Vinkius account to connect BR Business Days Calculator 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 BR Business Days Calculator with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Brazilian SLA Calculations

`add_business_days` guarantees that your date math returns validated, predictable data. Pydantic AI enforces strict runtime validation on every tool output. This MCP tool handles the math, and the framework parses it against strict schemas, preventing silent failures or corrupted variables. Your agent calls this tool to calculate delivery windows or payment schedules. Because the framework is model-agnostic, you get the same reliable date math across OpenAI, Anthropic, or local models.

Strict Validation for Brazilian Working Days

`is_business_day` provides immediate validation for any ISO date string your agent processes. If your agent tries to schedule an event on a weekend or a Brazilian national holiday, this tool flags it. The framework catches any unexpected return types instantly, failing loudly if something is off. This strictness is crucial for financial pipelines. You avoid the risk of your agent hallucinating a business day and triggering a process that hangs over a long holiday weekend.

Connecting the MCP Server to Pydantic AI

Connecting the MCP Server to Pydantic AI is straightforward using the unified `MCPToolset` class. This setup bypasses deprecated HTTP classes and establishes a direct connection to the Vinkius external host. The agent automatically registers the tools and validates their inputs at runtime. The framework supports both Streamable HTTP and SSE transports. This flexibility allows your production agent to maintain stable connections to the calendar engine even under heavy load.

Setup guide

Set up BR Business Days Calculator 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": {
        "br-business-days-calculator-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent BR Business Days Calculator 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 date-fns. 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 BR Business Days Calculator 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 BR Business Days Calculator MCP in Pydantic AI

Install the library with pip install "pydantic-ai-slim[mcp]". Use the MCPToolset class to connect to your Vinkius server URL, and pass it to your agent's toolsets parameter.

The framework will raise a validation error instantly. This prevents the agent from continuing with bad data, ensuring your application state remains completely clean.

Yes, the toolset is model-agnostic. You can use it with local models run via Ollama or enterprise endpoints, and the date math will remain identical.

Yes, the underlying engine handles leap years and date offsets accurately. It uses standard ISO formats to prevent timezone mismatches from shifting your target days.

The server runs in a zero-trust, ephemeral V8 isolate. It only receives the raw ISO date strings and offset integers required for the calculation, saving nothing to disk.

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