Moloni MCP. Manage certified invoicing and VAT compliance.
Works with every AI agent you already use
…and any MCP-compatible client
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.
Find a customer's complete profile, including billing address and legal details, using their specific fiscal ID.
List or retrieve the detailed items and tax breakdown for specific certified invoices (FT) or write-off documents (NC).
Check current inventory counts, view raw movement logs, and list all articles and services with base pricing.
Create new client entries or update the fiscal data for an existing company profile.
List all active quotes and proforma estimates, helping track pending approvals before invoicing occurs.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
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.
019d75d7create customer
Registers a new client profile into Moloni's system.
019d75d7create product
Sets up the record for a brand new, billable product or service article.
019d75d7get customer by vat
Finds and retrieves all registered customer details using an exact fiscal NIF ID.
019d75d7get invoice
Retrieves the itemized list and tax breakdown for a specific, existing invoice number.
019d75d7get product
Gets detailed unit information and associated tax ID tags for a product or service.
019d75d7list countries
Lists available ISO IDs and legal fiscal jurisdictions used by Moloni.
019d75d7list credit notes
Retrieves a list of legally issued credit notes (NCs) for tracking write-offs.
019d75d7list customers
Lists every customer record currently registered in the Moloni company account.
019d75d7list delivery notes
Retrieves a list of physical transport guidelines (GTs) linked to shipments.
019d75d7list estimates
Shows all currently active quotes and proforma estimates for pending client approval.
019d75d7list invoice receipts
Lists equivalent Portuguese invoice-receipt records (FRV).
019d75d7list invoices
Retrieves a list of finalized or open primary invoices (AT) for billing history.
019d75d7list measurement units
Lists all measurement units configured in the system, like meters or liters.
019d75d7list payment methods
Retrieves IDs for payment methods that can be associated with an invoice.
019d75d7list product categories
Lists the hierarchical structure used to organize and classify products.
019d75d7list product stocks
Consults auditable records of raw stock movements across all warehouses.
019d75d7list products
Lists the names and current service inventory items managed by Moloni.
019d75d7list receipts
Retrieves a list of settled liquidity receipts (RCs).
019d75d7list taxes
Shows all active VAT rates and tax exemptions configured for the account.
019d75d7update 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
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 Subscribe to the Moloni server.
- 2 Enter your unique Moloni Access Token and Company ID into your AI client settings.
- 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.
Uses list_invoices and get_invoice to pull detailed transaction reports, verifying tax breakdowns for quarterly filings.
Directs the agent to check customer details using get_customer_by_vat, ensuring compliance before sending a major quote.
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_taxesto see all active VAT rates and exemptions needed for compliant billing in one chat command. - Track the entire sales cycle. Use
list_estimatesto pull up pending quotes (proformas) and track which client approvals are stalled before they become invoices. - Know your inventory status immediately. Running
list_product_stocksgives 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_vatto 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) orlist_invoice_receipts(FRV) directly, which is critical for tax auditing. - Update data without logging in. Use
update_customerto correct a client's fiscal address or name using only conversational input.
Real-World Use Cases
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.
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.
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.
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
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
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Bexio
Manage your business via Bexio — list contacts, invoices, and projects directly from any AI agent.
AlisQI
Quality management orchestration — manage analysis sets, results, and QMS data via AI.
Xero
Manage invoices, bank transactions, and financial reports on Xero — the beautiful accounting software for small business.
You might also like
Poké
Access the ultimate Pokémon encyclopedia — query berries, contest effects, and encounter methods directly from your AI agent.
Mealie (Recipe Manager)
Manage your Mealie recipes, meal plans, and shopping lists directly through your AI agent.
GPTBots
Manage your conversational AI agents, workflows, and knowledge bases via AI.