How to Use the Mollie MCP in Pydantic AI
Validate your Mollie transactions with Pydantic AI for total operational accuracy.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Mollie MCP to Pydantic AI
Create your Vinkius account to connect Mollie 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.
Validate payments in Pydantic AI
Invoke `create_payment` and watch as Pydantic AI checks the response against your defined models. If the API returns unexpected fields, the agent stops immediately. This prevents silent errors in your checkout flow. You know exactly what data your agent is working with at every step.
Query orders with Pydantic AI
Use `get_order` to pull data into your Pydantic AI agent with full type safety. The framework ensures that shipping and item details match your expected structure. Your code becomes more reliable by catching formatting issues at runtime. You never have to worry about hallucinated fields in your financial reports.
Audit transactions via Pydantic AI
Use `list_payments` to retrieve your history for reconciliation. Pydantic AI validates the list, ensuring every transaction record is complete before your agent processes it. This provides a safety net for your financial data. You get the speed of automation with the strictness of typed code.
Set up Mollie 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 deprecatedMCPServerHTTPclass with full protocol support. - 2
Configure the FastMCPToolset
Pass a JSON-style config dict to
FastMCPToolsetwith 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 callagent.run(). Swapopenai:gpt-4ofor any supported model — Anthropic, Google, Mistral, or Groq.
from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset
toolset = FastMCPToolset({
"mcpServers": {
"mollie-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
})
agent = Agent(
"openai:gpt-4o",
toolsets=[toolset],
system_prompt="You have access to Mollie tools.",
)
result = await agent.run("List recent Mollie transactions")
print(result.output) Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mollie. 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.
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 Mollie MCP in Pydantic AI
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Mollie MCP today
We host it, we monitor it, we maintain it. You just paste one token.