Zulu MCP by usefulapi

Read invoices, payments and customers; create drafts and record payments in Zulu.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
76%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'zulu_update_customer' description lacks action verbin zulu_update_customer

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,878Tokens (tool definitions)
~1.8 KBTypical response size
Significant attention impact (2.25% of 128k context)

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-http

What it can do

Tool inventory

Tools (13)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded13 tools