# Wuro MCP MCP

> Wuro MCP connects your AI client directly to Wuro.fr to handle core business administration tasks. You can manage customer records, generate invoices and quotes, track products in your catalog, monitor employee leave requests, and even record company purchases—all through natural conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** billing-automation, invoicing, quote-management, crm, business-resources

## Description

This connector lets you run your entire back office through your agent. Need to create a new client contact or pull up the status of last month's accounts? You tell your AI what you need, and it handles the Wuro system calls for you. It’s about moving away from jumping between tabs and dashboards just to process basic paperwork.

The tool gives you control over everything: generating customer bills (Factures), drafting estimates (Devis), managing who your contacts are, or even listing all available products in stock. Plus, if you need a full picture of what happened—like tracking every change made to an invoice or which product was billed when—you get cryptographically signed audit trails right through the Vinkius platform. This means every transaction is tamper-proof by design. You connect once from your favorite client, and suddenly all that financial data becomes available for conversation.

## Tools

### create_contact
Creates a brand new customer or supplier contact record in Wuro's database.

### create_invoice
Generates and saves a new customer invoice based on specified contacts and product lines.

### create_quote
Drafts a new estimate or quote document using contact IDs and itemized product lines.

### get_contact
Fetches the full details for one specific contact using their ID.

### get_invoice
Retrieves every detail for one specific, existing customer invoice.

### get_quote
Gets full details for a single, specific quote or estimate document.

### list_contacts
Retrieves a list of all existing contacts, allowing you to search by name or other metadata.

### list_employees
Provides a list of all employees, useful for tracking records or leave requests.

### list_invoices
Gets an overview list of all invoices created in the Wuro system.

### list_products
Lists every product available in your catalog and shows their current pricing structure.

### list_purchases
Retrieves an overview of all company purchases and supplier expenses recorded by the firm.

### list_quotes
Shows an overview list of all quotes/estimates saved in the system.

## Prompt Examples

**Prompt:** 
```
List my 5 most recent invoices in Wuro.
```

**Response:** 
```
I've retrieved your latest invoices. The most recent is Invoice #F-2024-001 (Total: €1,250.00, Status: Paid). Would you like the details for any other record?
```

**Prompt:** 
```
Create a new contact 'Jean Dupont' with email jean@example.com.
```

**Response:** 
```
Successfully created the contact 'Jean Dupont' in Wuro. He has been added to your database as a new client prospect. Would you like to create a quote for him?
```

## Capabilities

### Manage Customer Records
Creates new contacts, retrieves details on specific clients, or lists your entire database of leads.

### Automate Billing Documents
Generates full customer invoices and drafts professional quotes using provided contact IDs and line items.

### Track Financial Movements
Retrieves details on specific bills, lists all historical invoices, or shows company purchases made by the firm.

### Control Product Inventory Data
Fetches a current list of every product and monitors detailed pricing information across your catalog.

### Administer HR Tasks
Lists employee records or processes leave requests directly via natural language commands.

## Use Cases

### The Accountant needs to know the status of Q2 billing.
Instead of running reports and manually checking multiple invoices, the accountant asks their agent to `list_invoices`. The agent immediately provides a clean list, showing which ones are paid and which need follow-up.

### The Sales Rep needs to onboard a new client quickly.
The rep uses the agent to first `create_contact` for the new client. Then, they ask the agent to draft an initial estimate using `create_quote`, linking the contact ID and necessary products.

### The Manager needs to track employee time off.
Instead of opening the HR module, the manager simply asks their agent to list employees (`list_employees`) and then process a leave request for a specific person using natural language.

## Benefits

- Instead of manually logging into Wuro to draft a bill, you just tell your agent to generate a new invoice using the `create_invoice` tool. It handles all the line items and saves it instantly.
- You can list every contact (`list_contacts`) or get a specific person's details (`get_contact`), making it fast to find who you need data on—no more scrolling through spreadsheets.
- Need to see if an estimate is ready? Use `list_quotes` to check the status of all outstanding quotes, saving time compared to manual dashboard checking.
- Tracking spending used to mean exporting and reconciling sheets. Now, use `list_purchases` to get a clear overview of company expenses right inside your agent chat.
- When you combine multiple MCPs, say using Wuro alongside a messaging service, you build complex automations—all through one AI agent—that span platforms seamlessly.

## How It Works

The bottom line is: your agent runs administrative tasks against Wuro.fr without you ever needing to log into the website yourself.

1. Subscribe to the Wuro MCP and input your public and private API keys from your Wuro account settings.
2. Connect your preferred AI client (Claude, Cursor, etc.) to Vinkius using that single connection point.
3. Tell your agent what you need—for example, 'List all invoices for Client X'—and the MCP executes the necessary calls.

## Frequently Asked Questions

**How do I list all my customer invoices using the `list_invoices` tool?**
You tell your agent, 'List all customer invoices.' The MCP executes this and provides a summary of every invoice number, total, and status without you needing to know any specific IDs.

**Does the Wuro MCP handle my product catalog pricing? Which tool do I use?**
Yes. Use the `list_products` tool. It pulls all current product names and their associated prices right into your chat, keeping your data up to date automatically.

**`create_invoice` requires a contact ID; how does the agent know which one to use?**
You simply give the agent enough context in your prompt—like 'Client X' or 'the billing for John Smith.' The MCP figures out the correct contact ID internally before running `create_invoice`.

**When I run `list_contacts`, do I need to provide specific parameters or is it a full list?**
The `list_contacts` tool retrieves your entire directory of records. It doesn't require initial parameters; the agent simply pulls all available contacts from Wuro.fr into the conversation.

**If I try to generate a quote using `create_quote`, what happens if the contact ID is invalid?**
The system will return an error detailing the invalid ID, preventing data corruption. You must verify the correct client identifier before attempting to build any estimate.

**How can I track my company's spending using the `list_purchases` tool?**
The `list_purchases` tool accesses all logged vendor and operational expenses. You get a clear overview of every recorded outlay, helping you reconcile your firm’s accounts.

**Does `get_contact` retrieve historical data or just the current details for an individual?**
The `get_contact` tool retrieves the most up-to-date record available in Wuro.fr. It focuses on current metadata and status, not a chronological history of changes.

**I need to see all employee records; should I use the `list_employees` command?**
Yes, running `list_employees` pulls a comprehensive roster of every person in your firm's system. This is the central way to view current staff details and leave statuses.

**How do I obtain my Public and Private API Keys?**
Log in to your Wuro account, navigate to **Paramètres** (Settings) > **Intégration** > **API REST**, and generate your set of keys there.

**Is the connection secure?**
Yes. The integration uses HMAC-SHA1 signatures to authenticate every request, ensuring that your Private API Key is used to sign requests without being transmitted directly in every header.