How to Use the Moloni (Cloud Invoicing & Fiscal Management) MCP in Pydantic AI

Q: Can my Pydantic AI agent check stock levels in Moloni (Cloud Invoicing & Fiscal Management) via the MCP Server?

Yes. The agent calls listproductstocks to query active inventory levels. Because the response is fully validated, your agent can make accurate decisions on whether to draft new sales documents.

Q: How do I query customer records by VAT?

Your agent uses the getcustomerbyvat tool to locate exact customer profiles. This ensures you never create duplicate records for existing tax entities.

Execute type-safe, validated fiscal operations in Pydantic AI using certified Moloni tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Moloni (Cloud Invoicing & Fiscal Management) MCP to Pydantic AI

Create your Vinkius account to connect Moloni (Cloud Invoicing & Fiscal Management) 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 Moloni (Cloud Invoicing & Fiscal Management) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pydantic AI guarantees type-safe customer creation

The `create_customer` tool registers new clients in Moloni using strict data parameters. Pydantic AI validates the inputs at runtime, ensuring your agent never sends malformed tax IDs or broken addresses to the API. This eliminates API errors before they happen. If you need to update a profile, the agent uses `update_customer` to modify the record. Every field is checked against your defined schemas, preventing database corruption.

Audit invoices with strict runtime validation

The `get_invoice` tool retrieves granular invoice details, including line items and VAT breakdowns. Your agent parses this data securely, ensuring every number matches your local Pydantic models. This MCP Server ensures you never process hallucinated financial figures. To check broader trends, the agent calls `list_invoices` to scan your transaction history. It matches tax periods and document states with absolute precision.

Track invoice receipts and credit notes

The `list_invoice_receipts` tool fetches Portuguese Fatura-Recibo documents to confirm completed sales. Your agent uses these records to close out open balances in your local database. It guarantees that every payment is logged against a certified document. When refunds occur, the agent queries `list_credit_notes` to log the adjustments. It uses `list_measurement_units` to ensure returned quantities use the correct fiscal units.

Setup guide

Set up Moloni (Cloud Invoicing & Fiscal Management) 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": {
        "moloni-cloud-invoicing-fiscal-management-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Moloni (Cloud Invoicing & Fiscal Management) tools.",
)

result = await agent.run("List recent Moloni (Cloud Invoicing & Fiscal Management) 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 Moloni. 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 Moloni (Cloud Invoicing & Fiscal Management) 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 Moloni (Cloud Invoicing & Fiscal Management) MCP in Pydantic AI

Install the MCP extension and initialize MCPToolset with your Vinkius HTTP URL. Pass this toolset into your Agent constructor. This exposes all 20 certified invoicing tools to your model with automatic runtime schema validation.

The framework will raise a validation error immediately. This prevents your agent from operating on malformed invoice data or writing corrupted records back to your database.

Yes. The agent calls `list_product_stocks` to query active inventory levels. Because the response is fully validated, your agent can make accurate decisions on whether to draft new sales documents.

Your agent uses the `get_customer_by_vat` tool to locate exact customer profiles. This ensures you never create duplicate records for existing tax entities.

All operations involving customer VATs, inventory stock levels, and invoice details are processed through Vinkius's isolated runtime. No financial data is cached on external servers, and your API credentials are encrypted end-to-end to maintain strict compliance.

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