Hobok MCP by usefulapi

Add a saved customer with a name and optional address and contact fields. POST /v1/clients. Hobok documents no idempotency key here. A network or timeout error does not say whether the record was saved: list the records first before you retry.

Issue an invoice with status sent. It takes the next invoice number, which cannot be reused. Give client_id for a saved customer, or buyer for a one-off buyer, not both. VAT is always 0. The invoice is emailed only when send_email is true. POST /v1/invoices with an Idempotency-Key. Retrying the same request with the same key does not issue a second invoice. Two separate invoices with the same content need different idempotency_key values, or the second call returns the first invoice. A network or timeout error does not say whether the record was saved: list the records first before you retry.

Add a saved product or service with its price in SEK. POST /v1/products. Hobok documents no idempotency key here. A network or timeout error does not say whether the record was saved: list the records first before you retry.

Queue the payment receipt of a paid invoice for delivery to the buyer. A 200 means queued, not delivered. The API has no idempotency key here: a retry can send the receipt twice, so check hobok_get_invoice first. POST /v1/invoices/{local_id}/receipt/email.

Fetch one invoice with its lines, totals, status and emails sent. GET /v1/invoices/{local_id}.

Show the hobby business this API key is bound to, the plan, the next invoice number, the payment terms and the currency. GET /v1/me.

List the saved customers of the hobby business. Use an id from this list as client_id in hobok_create_invoice. GET /v1/clients.

List invoices, optionally by status (sent, paid, credited). Each invoice has its number, buyer, lines, totals and dates. GET /v1/invoices.

List the payment method values that hobok_mark_invoice_paid accepts. Each value is in Swedish and is printed on the receipt. GET /v1/payment-methods.

List the saved products and services of the hobby business, with their prices. GET /v1/products.

Record that a sent invoice was paid. Hobok creates the receipt and books the income for the year. Only a sent invoice can be marked paid; any other status returns 409. POST /v1/invoices/{local_id}/mark-paid with an Idempotency-Key. Use hobok_list_payment_methods for payment_method values. A network or timeout error does not say whether the record was saved: list the records first before you retry.