Zulu MCP by usefulapi
Read invoices, payments and customers; create drafts and record payments in Zulu.
Should I use this
Quality & Safety
Findings (1)
- LOWin zulu_update_customer
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"zulu": {
"url": "https://zulu.usefulapi.io/mcp"
}
}
}Remote endpoints
https://zulu.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (13)
🟢zulu_get_business
Get the business the API key belongs to: name, details and VAT number. Zulu API: GET /business.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_get_plan
Get the business's plan, its limits and current usage, such as e-mails sent today. Zulu API: GET /business/plan.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_list_invoices(query, limit, after, before, status, ...)
List invoices and credit notes, newest first. Filter by status, type, customer, overdue or part-paid. Zulu API: GET /invoice.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Search text. Matches the main name or number, ignoring case.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Records per page, 1-50. Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"after": {
"description": "The last id of the previous page, to get the next page.",
"type": "string",
"minLength": 1
},
"before": {
"description": "The first id of the current page, to get the previous page.",
"type": "string",
"minLength": 1
},
"status": {
"description": "Only invoices with this status.",
"type": "string",
"enum": [
"draft",
"open",
"paid",
"uncollectible",
"void"
]
},
"type": {
"description": "invoice or credit_note.",
"type": "string",
"enum": [
"invoice",
"credit_note"
]
},
"contact_id": {
"description": "Only invoices billed to this customer id.",
"type": "string",
"minLength": 1
},
"overdue": {
"description": "true: only open invoices past their due date.",
"type": "boolean"
},
"part_paid": {
"description": "true: only open invoices with some payment received.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_get_invoice(invoice_id)
Get one invoice or credit note by id, with its items, totals, amount due and status. Zulu API: GET /invoice?id=.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The invoice id."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_get_invoice_summary
Get totals per currency: outstanding, overdue, and paid and issued this month and last month. Zulu API: GET /invoice/summary.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_next_invoice_number(type)
Suggest the next free invoice or credit note number in the business's format. Zulu API: GET /invoice/next-number.
Input Schema
{
"type": "object",
"properties": {
"type": {
"description": "invoice (default) or credit_note.",
"type": "string",
"enum": [
"invoice",
"credit_note"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_list_invoice_payments(invoice_id, query, limit, after, before)
List payments received against invoices, newest first. Pass invoice_id to list one invoice's payments. Zulu API: GET /invoice/payment.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"description": "Only payments against this invoice id.",
"type": "string",
"minLength": 1
},
"query": {
"description": "Search text. Matches the main name or number, ignoring case.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Records per page, 1-50. Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"after": {
"description": "The last id of the previous page, to get the next page.",
"type": "string",
"minLength": 1
},
"before": {
"description": "The first id of the current page, to get the previous page.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_list_invoice_sends(invoice_id, status, query, limit, after, ...)
List when invoices were e-mailed, to whom, and the delivery status. Read only: this tool sends nothing. Zulu API: GET /invoice/send.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"description": "Only e-mails for this invoice id.",
"type": "string",
"minLength": 1
},
"status": {
"description": "Only e-mails with this delivery status.",
"type": "string",
"enum": [
"pending",
"scheduled",
"sent",
"delivered",
"bounced",
"complained",
"failed",
"cancelled"
]
},
"query": {
"description": "Search text. Matches the main name or number, ignoring case.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Records per page, 1-50. Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"after": {
"description": "The last id of the previous page, to get the next page.",
"type": "string",
"minLength": 1
},
"before": {
"description": "The first id of the current page, to get the previous page.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zulu_list_customers(id, query, limit, after, before)
List customers (contacts) with their e-mails, phones and addresses. Search by name, or pass id for one customer. Zulu API: GET /contact.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "One customer id. Leave out to list.",
"type": "string",
"minLength": 1
},
"query": {
"description": "Search text. Matches the main name or number, ignoring case.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Records per page, 1-50. Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"after": {
"description": "The last id of the previous page, to get the next page.",
"type": "string",
"minLength": 1
},
"before": {
"description": "The first id of the current page, to get the previous page.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zulu_create_customer(first_name, last_name, company_name, vat_number, email, ...)
Create a customer with its e-mails, phones and addresses in one request. Zulu API: POST /contact.
Input Schema
{
"type": "object",
"properties": {
"first_name": {
"type": "string",
"maxLength": 200
},
"last_name": {
"type": "string",
"maxLength": 200
},
"company_name": {
"type": "string",
"maxLength": 200
},
"vat_number": {
"type": "string",
"maxLength": 30
},
"email": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "A label, e.g. Accounts."
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"first_name": {
"type": "string",
"maxLength": 200
},
"last_name": {
"type": "string",
"maxLength": 200
},
"is_primary": {
"description": "Use this address on invoices.",
"type": "boolean"
}
},
"required": [
"name",
"email"
]
}
},
"phone": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "A label, e.g. Office."
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"is_primary": {
"type": "boolean"
}
},
"required": [
"name",
"phone"
]
}
},
"address": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "A label, e.g. Head office."
},
"address_1": {
"type": "string",
"maxLength": 200
},
"address_2": {
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"maxLength": 200
},
"county": {
"type": "string",
"maxLength": 200
},
"eircode": {
"type": "string",
"maxLength": 200
},
"country": {
"type": "string",
"maxLength": 200
},
"is_primary": {
"description": "Use this address on invoices.",
"type": "boolean"
}
},
"required": [
"name"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zulu_update_customer(customer_id, first_name, last_name, company_name, vat_number)
Change a customer's name, company or VAT number. Fields you leave out stay as they are. Zulu API: PATCH /contact.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The customer id."
},
"first_name": {
"type": "string",
"maxLength": 200
},
"last_name": {
"type": "string",
"maxLength": 200
},
"company_name": {
"type": "string",
"maxLength": 200
},
"vat_number": {
"type": "string",
"maxLength": 30
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zulu_create_invoice_draft(name, number, date, due_date, currency, ...)
Create a draft invoice. A draft can be edited later in Zulu. It is not issued and not e-mailed. Zulu works out totals and VAT. Zulu API: POST /invoice.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Invoice title, e.g. the job or project name."
},
"number": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Invoice number, e.g. INV-0042. See zulu_next_invoice_number."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as YYYY-MM-DD."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as YYYY-MM-DD."
},
"currency": {
"description": "ISO 4217 code, e.g. EUR. Default EUR.",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"notes": {
"type": "string",
"maxLength": 5000
},
"contact_id": {
"description": "The customer to bill (customer id). Zulu copies their details.",
"type": "string",
"minLength": 1
},
"items": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"catalog_id": {
"description": "A saved item id. Zulu copies its name, price and VAT.",
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"category": {
"description": "e.g. service or product.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"quantity": {
"description": "Quantity as a string, e.g. \"2\".",
"type": "string",
"pattern": "^\\d+(\\.\\d{1,4})?$"
},
"unit_price": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"description": "Amount as a string with up to 2 decimals, e.g. \"120.50\"."
},
"vat_id": {
"description": "A VAT rate id for this line.",
"type": "string",
"minLength": 1
}
}
}
}
},
"required": [
"name",
"number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zulu_record_invoice_payment(invoice_id, amount, date, method, reference)
Record money received against an open invoice, in full or in part. It cannot be more than the amount due. Zulu API: POST /invoice/payment.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The invoice id."
},
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"description": "Amount as a string with up to 2 decimals, e.g. \"120.50\"."
},
"date": {
"description": "When the money arrived. Default: today (Irish time).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"method": {
"type": "string",
"enum": [
"bank_transfer",
"card",
"cash",
"cheque",
"other"
]
},
"reference": {
"description": "A bank reference or receipt number.",
"type": "string",
"maxLength": 100
}
},
"required": [
"invoice_id",
"amount"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence