4,500+ servers built on MCP Fusion
Vinkius

Moloni MCP. Manage certified invoicing and VAT compliance.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Moloni (Cloud Invoicing & Fiscal Management) MCP on Cursor AI Code Editor MCP Client Moloni (Cloud Invoicing & Fiscal Management) MCP on Claude Desktop App MCP Integration Moloni (Cloud Invoicing & Fiscal Management) MCP on OpenAI Agents SDK MCP Compatible Moloni (Cloud Invoicing & Fiscal Management) MCP on Visual Studio Code MCP Extension Client Moloni (Cloud Invoicing & Fiscal Management) MCP on GitHub Copilot AI Agent MCP Integration Moloni (Cloud Invoicing & Fiscal Management) MCP on Google Gemini AI MCP Integration Moloni (Cloud Invoicing & Fiscal Management) MCP on Lovable AI Development MCP Client Moloni (Cloud Invoicing & Fiscal Management) MCP on Mistral AI Agents MCP Compatible Moloni (Cloud Invoicing & Fiscal Management) MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

Moloni MCP Server handles certified invoicing and full fiscal compliance for businesses operating in Portugal and Spain. It lets your AI agent find customers by VAT/NIF, audit specific invoices or credit notes, track real-time product stock levels, and manage all commercial estimations without opening the main dashboard.

What your AI agents can do

Create customer

Registers a new client profile into Moloni's system.

Create product

Sets up the record for a brand new, billable product or service article.

Get customer by vat

Finds and retrieves all registered customer details using an exact fiscal NIF ID.

+ 17 more capabilities included
Search customers by VAT/NIF

Find a customer's complete profile, including billing address and legal details, using their specific fiscal ID.

Audit invoices and credit notes

List or retrieve the detailed items and tax breakdown for specific certified invoices (FT) or write-off documents (NC).

Monitor product stock levels

Check current inventory counts, view raw movement logs, and list all articles and services with base pricing.

Manage customer records

Create new client entries or update the fiscal data for an existing company profile.

View sales pipeline estimates

List all active quotes and proforma estimates, helping track pending approvals before invoicing occurs.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

Moloni: 20 Tools for Invoice & Fiscal Management

Use these tools to manage every aspect of your business—from creating a new product to auditing tax rates and listing all active client records.

create019d75d7

create customer

Registers a new client profile into Moloni's system.

create019d75d7

create product

Sets up the record for a brand new, billable product or service article.

get019d75d7

get customer by vat

Finds and retrieves all registered customer details using an exact fiscal NIF ID.

get019d75d7

get invoice

Retrieves the itemized list and tax breakdown for a specific, existing invoice number.

get019d75d7

get product

Gets detailed unit information and associated tax ID tags for a product or service.

list019d75d7

list countries

Lists available ISO IDs and legal fiscal jurisdictions used by Moloni.

list019d75d7

list credit notes

Retrieves a list of legally issued credit notes (NCs) for tracking write-offs.

list019d75d7

list customers

Lists every customer record currently registered in the Moloni company account.

list019d75d7

list delivery notes

Retrieves a list of physical transport guidelines (GTs) linked to shipments.

list019d75d7

list estimates

Shows all currently active quotes and proforma estimates for pending client approval.

list019d75d7

list invoice receipts

Lists equivalent Portuguese invoice-receipt records (FRV).

list019d75d7

list invoices

Retrieves a list of finalized or open primary invoices (AT) for billing history.

list019d75d7

list measurement units

Lists all measurement units configured in the system, like meters or liters.

list019d75d7

list payment methods

Retrieves IDs for payment methods that can be associated with an invoice.

list019d75d7

list product categories

Lists the hierarchical structure used to organize and classify products.

list019d75d7

list product stocks

Consults auditable records of raw stock movements across all warehouses.

list019d75d7

list products

Lists the names and current service inventory items managed by Moloni.

list019d75d7

list receipts

Retrieves a list of settled liquidity receipts (RCs).

list019d75d7

list taxes

Shows all active VAT rates and tax exemptions configured for the account.

update019d75d7

update customer

Modifies the fiscal data or details of an already existing customer record.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Moloni (Cloud Invoicing & Fiscal Management), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

Listen up. This isn't some basic accounting server; this is your full-stack, certified fiscal brain for Moloni—specifically built for running books in Portugal and Spain. You connect your AI client, and it gives your agent total control over everything from setting up a new product line to filing off a credit note.

You don't gotta open the main dashboard to run any of this; you just talk to your agent.

When you need to handle clients, you can find them fast by punching in their exact fiscal ID using get_customer_by_vat, or you can list every profile currently active with list_customers. If a client is new, use create_customer to register their full profile; if something changes—like an address or tax status—you just update it with update_customer.

To manage the money flow, you've got tools for every stage. You can look at all your pending client quotes and proforma estimates using list_estimates, which keeps track of what needs approval before billing hits. Once that’s done, you pull up a list of finalized or open primary invoices with list_invoices.

For any specific invoice number, you get the full itemized breakdown and tax split by calling get_invoice. You can also pull records for Portuguese invoice-receipts using list_invoice_receipts, and track write-offs or corrections of revenue with list_credit_notes. The system tracks all your available payment methods via list_payment_methods.

For inventory, you can set up a brand new billable product or service article using create_product, and then grab detailed unit info and tax tags for any existing item with get_product. You'll find the full list of managed items through list_products, and if you need to organize them, your agent can use list_product_categories to view the official classification structure.

When it comes to stock, you check auditable records of raw movement across all warehouses with list_product_stocks, which keeps you locked into accurate counts for every article sold.

Beyond daily sales, the server handles compliance boilerplate: you can list all configured tax rates and exemptions using list_taxes. You'll find support for multiple jurisdictions by running list_countries to see available ISO IDs. For physical shipments, list_delivery_notes gives you a rundown of transport guidelines (GTs). Plus, your agent can look up every measurement unit configured—whether it’s meters or liters—with list_measurement_units.

You've also got access to the foundational data needed for any transaction: listing all available product categories with list_product_categories, getting a list of settled liquidity receipts (RCs) via list_receipts, and even seeing what raw stock movements happened across every location using list_product_stocks.

Basically, you use this to run your books completely in the cloud. You're checking customer details by their NIF/VAT, reviewing detailed invoices and credit notes, monitoring real-time stock counts, managing client profiles, and seeing exactly what money is sitting in the pipeline before it’s ready to bill.

How Moloni MCP Works

  1. 1 Subscribe to the Moloni server.
  2. 2 Enter your unique Moloni Access Token and Company ID into your AI client settings.
  3. 3 Start by telling your agent what you need. For example: 'What is the stock level for product X?' or 'List all invoices from last month.'

The bottom line is, you manage complex financial operations using simple chat commands instead of navigating multiple backend dashboards.

Who Is Moloni MCP For?

This is for the business owner who hates spending hours clicking through confusing accounting portals. It's for accountants who need specific tax data fast, and e-commerce managers who must verify stock levels against client profiles before shipping.

Accountant

Uses list_invoices and get_invoice to pull detailed transaction reports, verifying tax breakdowns for quarterly filings.

Business Owner

Directs the agent to check customer details using get_customer_by_vat, ensuring compliance before sending a major quote.

E-commerce Manager

Runs list_product_stocks and list_estimates to reconcile inventory counts with pending sales orders in real time.

What Changes When You Connect

  • Audit tax liabilities instantly. Instead of manually pulling reports, use list_taxes to see all active VAT rates and exemptions needed for compliant billing in one chat command.
  • Track the entire sales cycle. Use list_estimates to pull up pending quotes (proformas) and track which client approvals are stalled before they become invoices.
  • Know your inventory status immediately. Running list_product_stocks gives you raw, auditable movement logs for every article, letting you prevent overselling without checking the physical warehouse terminal.
  • Verify customer legal standing fast. Use get_customer_by_vat to confirm a client's official NIF/VAT status and billing address before generating any document.
  • Handle complex documentation. The server lets you list specific records like list_credit_notes (NCs) or list_invoice_receipts (FRV) directly, which is critical for tax auditing.
  • Update data without logging in. Use update_customer to correct a client's fiscal address or name using only conversational input.

Real-World Use Cases

01

Need to confirm if a new vendor exists and is valid?

A business owner needs to invoice a potential partner. Instead of calling the accounting department, they ask their agent: 'Find the customer with NIF XXXXX.' The agent uses get_customer_by_vat, confirming the legal name and active status immediately.

02

Running year-end tax reconciliation for a client.

The accountant needs to reconcile all sales from Q4. They ask the agent: 'List all invoices, receipts, and credit notes.' The agent uses list_invoices, list_invoice_receipts, and list_credit_notes sequentially, providing a complete audit trail in one response.

03

Preparing for an urgent shipment.

The e-commerce manager needs to ship 50 units of Product Z. They first check the stock using list_product_stocks, confirming availability. Then, they use get_delivery_notes to ensure the required transport documents are ready.

04

Fixing an old client's billing address.

A client calls with a wrong VAT address. The agent first runs get_customer_by_vat to pull up the current record, then uses update_customer to change only the required fiscal metadata and zip code.

The Tradeoffs

Assuming data is always available.

The user asks the agent, 'Show me all sales reports from last month,' expecting a single dashboard view. The system fails because it doesn't know which specific document type they mean (invoice, quote, or receipt).

Don't ask for vague 'reports.' Instead, tell your agent exactly what you need: 'List the open invoices using list_invoices,' or 'Show me all pending quotes with list_estimates.'

Trying to manually merge different data points.

A user tries to combine product details, customer names, and tax rates by copying them from three separate tabs in the Moloni UI into their prompt. This is tedious and prone to copy-paste errors.

Let your agent do it. Use get_customer_by_vat first for the client data, then use get_product for the item details. The AI stitches these together.

Assuming stock levels are static.

A user asks, 'How much stock do we have?' and gets a single number without context. They don't know if that count includes recent outbound sales or pending returns.

Always ask for the movement logs. Use list_product_stocks to get raw, auditable data on inventory changes.

When It Fits, When It Doesn't

Use this server when your process involves complex fiscal checks across multiple domains: Customer, Product, and Invoice. If you need to confirm VAT compliance before issuing a quote, or audit historical tax rates (using list_taxes), this is what you use. You must use it if the task requires knowing the specific relationship between a client's NIF and their billing history.

Don't use this server if your only goal is to read simple data that doesn't require fiscal context—for example, just listing employee names or basic contact info. For those, a general directory lookup tool works fine. If you are only managing product SKUs without any tax implications, a simpler inventory management API might be enough.

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.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 20 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

create_customer create_product get_customer_by_vat get_invoice get_product list_countries list_credit_notes list_customers list_delivery_notes list_estimates list_invoice_receipts list_invoices list_measurement_units list_payment_methods list_product_categories list_product_stocks list_products list_receipts list_taxes update_customer

Manually compiling a full client audit is a nightmare.

Right now, if an accountant needs to verify a customer's billing history and check their current tax status, they have to jump between the CRM dashboard (to find the NIF), then navigate to the Invoicing tab (to see open invoices), and finally pull up the Tax Settings page (to confirm VAT rates). It takes 15 clicks and half an hour of context switching.

With this MCP server, you tell your agent: 'Audit client XYZ.' The agent runs `get_customer_by_vat` first. Then, it uses that ID to run `list_invoices` and cross-references the results with `list_taxes`. You get a single, compiled report in chat.

Moloni MCP Server: Audit customer data using `get_customer_by_vat`

Today, finding just the right client record means guessing if you need to search by name or tax ID. You might get a list of 10 partial matches and then manually click through each one to verify the correct NIF.

Now, you simply ask your agent: 'Get details for VAT ID XYZ.' The server runs `get_customer_by_vat` instantly, providing the confirmed legal entity data without any clicks or guesswork.

Common Questions About Moloni MCP

How do I check if a customer's NIF is correct using get_customer_by_vat? +

The get_customer_by_vat tool confirms the fiscal ID against Moloni’s registered database. It returns the official legal name and status, confirming validity for invoicing.

What is the difference between list_invoices and list_estimates? +

list_invoices shows completed or open billing records (meaning money was due or sent). list_estimates only shows quotes—pre-approval documents that haven't become a formal invoice yet.

Can I track stock movements with list_product_stocks? +

Yes. list_product_stocks pulls the raw, auditable movement logs for your inventory. It tells you why the stock count changed (e.g., sale, return) and when it happened.

How do I create a new client record? Do I use create_customer? +

Yes, create_customer handles formal registration of new clients. You must provide all necessary fiscal metadata for the record to be fully compliant.

If I suspect an invoice ID is wrong, how can I validate it before running get_invoice? +

You should first list all invoices using list_invoices to confirm the existence of the identifier. This prevents errors and ensures you pass a valid, active document ID into get_invoice for detail retrieval.

When do I need to use list_measurement_units before processing tax data or creating products? +

You must check list_measurement_units early in your workflow. This confirms that the system recognizes the correct base units (e.g., kilograms, liters) needed for calculating taxes and setting up new inventory items.

How do I modify a customer's fiscal details after running create_customer? +

Use update_customer to change existing client records. This tool allows you to push updated tax or address information to an account without having to delete and recreate the entire profile.

Which tool do I use specifically for listing returns, like Notas de Crédito (NCs), rather than general invoices? +

You need list_credit_notes. This tool focuses only on legal credit notes or adjustments—the documents used when you have to reverse sales or issue refunds—separating them from standard finished invoices.

Can I search for a customer by their NIF (VAT number) through my agent? +

Yes. Use the get_customer_by_vat tool and provide the exact numeric NIF. Your agent will retrieve the certified customer record, ensuring you have the correct fiscal identifiers before generating any new document in Moloni.

How do I check the internal lines and tax breakdown of an invoice? +

The get_invoice tool allows your agent to extract the explicit document body payload. You'll see the individual line items, unit prices, applied tax rates (IVA), and final document totals directly in your conversation.

Can my agent list all stock movements for a specific product? +

Absolutely. Use the list_product_stocks tool with a Product ID. Your agent will report the chronological mutations in your warehouse, helping you audit how inventory levels have changed over time for that specific item.

More in this category

You might also like

Built & Managed by Vinkius 30s setup 20 tools

We've already built the connector for Moloni. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 20 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.