How to Use the Flipt MCP in Pydantic AI

Q: How do I register the Flipt toolset in Pydantic AI?

Initialize the MCPToolset with your Flipt server URL and pass it to the agent constructor. The framework automatically converts the server's tools, like listflags, into typed Python functions.

Q: Can I use Pydantic AI to safely automate Flipt rule updates?

Yes, you can use createdistribution within a strictly typed agent loop. The type-safety guarantees that the agent only writes valid distributions that match your Flipt engine's schema.

Bring runtime type safety to Flipt feature flags by integrating Pydantic AI with this zero-trust 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 Flipt MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Flipt flag schemas at runtime with Pydantic AI

The `list_flags` tool returns your active Flipt feature flags directly into Pydantic AI's strict validation engine. Every flag, variant, and namespace is parsed against concrete Python types defined in your codebase. This strict typing prevents your Pydantic AI agent from making decisions based on hallucinated Flipt flag names or missing variants. You get absolute certainty that the feature flag state matches your code expectations before any agent logic executes.

Safely create variants using an MCP Server

The `create_variant` tool lets your Pydantic AI agent add new variations to existing Flipt flags while guaranteeing structural integrity. The agent must satisfy the strict Pydantic model requirements for variants before the API call is allowed. By checking the output against `list_rules`, the agent verifies that the new Flipt variant fits into your existing rollout strategy. If the validation fails, Pydantic AI halts, providing a clear error trace for your developers to debug.

Enforce strict targeting rule structures in Pydantic AI

The `create_constraint` tool requires your Pydantic AI agent to build targeting rules that strictly match your Flipt schema. Your agent cannot pass arbitrary JSON to your Flipt segments, ensuring your user targeting remains reliable. You use `list_segments` to verify that the target segment exists before applying the constraint in Pydantic AI. This double-check prevents the agent from routing production traffic to non-existent user groups.

Setup guide

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

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

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

Initialize the `MCPToolset` with your Flipt server URL and pass it to the agent constructor. The framework automatically converts the server's tools, like `list_flags`, into typed Python functions.

The Pydantic AI framework raises a validation error immediately, halting the agent before it can execute any flawed Flipt logic. This prevents corrupted data from `list_rollouts` from silently breaking your production routing.

Yes, you can use `create_distribution` within a strictly typed agent loop. The type-safety guarantees that the agent only writes valid distributions that match your Flipt engine's schema.

Yes, the toolset is completely model-agnostic. You can run your agent with local Ollama models or commercial APIs while maintaining the exact same type-safe tools like `list_namespaces`.

Your namespaces, flags, rollouts, segments, rules, and tokens are processed locally within your application memory. The Vinkius MCP Server manages the connection via a zero-trust sandbox, ensuring your configuration data is never exposed to external telemetry.

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