wefact-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WEFACT_API_KEY | Yes | Your WeFact API key. Generate in WeFact under Instellingen → API. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools for reading and modifying a WeFact administration via the v2 API. Use wefact_request for any endpoint not covered by a dedicated tool. All tools return parsed JSON from WeFact; errors are raised with the messages WeFact returned.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wefact_requestA | Call any WeFact controller/action directly. Use this for endpoints not covered by the dedicated tools below, or to pass parameters that the dedicated tools don't expose. Args: controller: WeFact controller name (e.g. "debtor", "invoice", "subscription", "creditinvoice", "product", "ticket", "group"). action: Action on that controller (e.g. "list", "show", "add", "edit", "delete", "send", "credit", "markaspaid"). params: Extra parameters as a dict. Field names match the WeFact docs at developer.wefact.com (e.g. "DebtorCode", "Identifier", "InvoiceLines"). Do NOT include the api_key. Returns: JSON-encoded response from WeFact. |
| list_debtorsA | List all debtors (customers). Args: search_at: Field to search in (e.g. "EmailAddress", "CompanyName", "DebtorCode"). Optional. search_for: Value to search for. Required if search_at is given. modified_since: ISO date or datetime. Only return debtors modified after this point. Critical for incremental sync. limit_pages: If set, fetch at most this many pages (each ~100 items). Default fetches all pages. |
| get_debtorA | Fetch a single debtor by DebtorCode (e.g. 'DB10000') or Identifier. |
| create_debtorA | Create a new debtor. Args: fields: Dict of WeFact debtor fields. Common ones: CompanyName, Initials, SurName, EmailAddress, Address, ZipCode, City, Country, TaxNumber, Sex. See developer.wefact.com for the full list. |
| update_debtorA | Update an existing debtor. Only fields you provide are changed. |
| list_invoicesB | List invoices. Args: status: WeFact invoice status (0=concept, 1=sent, 2=partly paid, 3=paid, 4=expired, 5=summation, 6=collection). Optional filter. debtor_code: Filter to a specific debtor. modified_since: ISO date for incremental sync. limit_pages: Cap on pages (1 = first page only). |
| get_invoiceB | Fetch one invoice by InvoiceCode (e.g. '202401001') or Identifier. |
| create_invoiceB | Create a draft invoice. Args: debtor_code: e.g. 'DB10000'. invoice_lines: list of line dicts. Each can have ProductCode, or free-form Description + PriceExcl + Number + TaxCode etc. extra_fields: any other invoice-level fields (Date, Term, Discount, ReferenceNumber, Comment, ...). |
| send_invoiceA | Send an existing draft invoice to the debtor. Args: invoice_code: e.g. '[concept]0001' for a draft. send_method: optional, e.g. 'email' or 'mail'. Omit for the debtor's default. |
| credit_invoiceC | Credit (reverse) an existing invoice. |
| mark_invoice_paidA | Mark an invoice as paid. Args: invoice_code: e.g. '202401001'. pay_date: ISO date. Defaults to today. payment_method: WeFact code, e.g. 'wire' for bank transfer ('banktransfer' is rejected as an invalid payment method). |
| list_productsC | List all products. |
| get_productC | Fetch a single product. |
| list_subscriptionsD | List subscriptions. |
| get_subscriptionC | Fetch a single subscription. |
| list_credit_invoicesC | List purchase invoices (inkoopfacturen). |
| get_credit_invoiceC | Fetch a single purchase invoice. |
| whoamiA | Sanity-check the API connection. Returns a tiny debtor list response. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| export_to_nixfact | Walk through exporting a full WeFact administration to NIXFact / ERPNext. Use this when you want a structured, repeatable migration plan. |
| feature_audit | Audit the live WeFact account to inventory every feature in use. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Most tools map cleanly to distinct resource/action pairs, especially for debtors and invoices. The main confusion is the `credit_invoice` action versus `list_credit_invoices`/`get_credit_invoice` purchase-invoice tools, plus the generic `wefact_request` escape hatch, but descriptions largely clarify intended use.
The surface is mostly consistent snake_case verb_noun naming (`get_invoice`, `list_debtors`, `create_debtor`, `update_debtor`, `send_invoice`). Exceptions are `wefact_request` and `whoami`, and the `credit_invoice` vs `credit_invoices` naming is potentially confusing.
At 18 tools, the set is slightly above the typical 3-15 range but reasonable for a WeFact accounting wrapper covering debtors, invoices, products, subscriptions, and credit invoices. Each tool maps to a recognisable endpoint, though the generic fallback plus many dedicated tools makes the surface somewhat heavier than ideal.
Core workflows are covered for invoices and debtors, but dedicated CRUD is uneven: debtors lack delete, invoices lack update/delete, and products, subscriptions, and credit invoices are only list/get. The generic `wefact_request` tool explicitly covers missing endpoints, so agents have a workaround rather than a hard dead end.