How to Use the Monnify MCP in Pydantic AI

Q: How do I add the Monnify MCP Server to a Pydantic AI agent?

Use the unified MCPToolset with your server URL and pass it to the agent's toolsets argument. This registers tools like initpayment instantly.

Q: Which MCP tool should I use to initialize a new payment?

Your agent should call initpayment to generate a payment reference. It can then track the payment's progress using the gettransaction tool.

Run type-safe Pydantic AI agents that manage Monnify payments and validate Nigerian virtual accounts at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Monnify MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Virtual Account Creation

The `reserve_account` tool creates a dedicated virtual bank account with strict runtime type-checking. Because Pydantic AI validates every API response against explicit schemas, any structural change in the account payload will trigger an immediate, readable validation error. You can safely run `get_account_details` via this MCP Server knowing that your agent cannot hallucinate account numbers or bank codes. This prevents your agent from passing malformed data to your internal database.

Strict Transaction Tracking with Pydantic AI

The `get_transaction` tool retrieves detailed payment statuses with absolute type guarantees. When your agent calls this endpoint, Pydantic AI parses the transaction state to ensure fields like amount, currency, and reference match your exact data models. If Monnify returns an unexpected status code or a null field, your application fails loudly instead of letting corrupted data slip through. This guarantees your `list_transactions` audit logs remain perfectly clean.

Validate Merchant Settlements and Invoices

The `list_settlements` tool fetches payout records directly into type-safe Python models. Your agent can cross-reference these settlements with active digital invoices by calling `list_monnify_invoices` in the same execution loop. This setup eliminates silent parsing failures during complex financial reconciliation. The agent uses `list_banks` to map settlements to correct routing targets, ensuring zero data mismatch.

Setup guide

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

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

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

Use the unified `MCPToolset` with your server URL and pass it to the agent's `toolsets` argument. This registers tools like `init_payment` instantly.

The SDK will raise a validation error immediately. This prevents your agent from acting on malformed transaction data or hallucinating status fields.

Yes, the framework supports async execution loops. Your agent can check `get_account_details` and trigger downstream actions without blocking your main event loop.

Your agent should call `init_payment` to generate a payment reference. It can then track the payment's progress using the `get_transaction` tool.

All transaction references and invoice payloads retrieved via `list_monnify_invoices` are processed inside temporary V8 isolates. No financial data or merchant API keys are stored.

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