How to Use the Habitify MCP in Pydantic AI

Q: Does Pydantic AI support the full Habitify toolset?

Yes, all ten tools are available. The MCPToolset class integrates them into your agent while keeping the types strictly defined.

Q: Can I use Habitify stats with Pydantic AI models?

You can map the output of gethabitstats to a custom model. This allows your agent to perform local analysis on your progress.

Strictly typed Habitify habit tracking for Pydantic AI agents to ensure total data integrity.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Habitify MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe habit management for Pydantic AI

Every tool response, like `list_habits`, is validated against Pydantic models. You get clean, predictable data structures every time. If the API returns unexpected values, the agent stops before processing bad data.

Reliable logging with Pydantic AI

Use `add_habit_log` with full schema validation. Your agent ensures every log entry matches your expected input format. This prevents the common issue of malformed logs breaking your historical stats.

Precise habit deletion and updates

Call `delete_habit` safely knowing the agent confirms the action against your schema. It provides a layer of safety for destructive operations. Your routine stays clean and accurate because the agent enforces strict rules on every call.

Setup guide

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

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

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

It provides runtime validation for all responses. If Habitify returns an unexpected field, the agent raises a validation error instead of silently failing.

Yes, all ten tools are available. The `MCPToolset` class integrates them into your agent while keeping the types strictly defined.

The framework catches transport errors during the SSE or HTTP request. You can define custom retry logic within your agent code.

You can map the output of `get_habit_stats` to a custom model. This allows your agent to perform local analysis on your progress.

Your habit data is processed within your local runtime. The MCP server ensures that only requested habit records are accessed, keeping your information private.

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