Hobok MCP by usefulapi
Read invoices, customers and products; issue invoices and record payments in Hobok.
Should I use this
Quality & Safety
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": {
"hobok": {
"url": "https://hobok.usefulapi.io/mcp"
}
}
}Remote endpoints
https://hobok.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢hobok_get_me
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hobok_list_payment_methods
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hobok_list_invoices(page, per_page, status)
List invoices, optionally by status (sent, paid, credited). Each invoice has its number, buyer, lines, totals and dates. GET /v1/invoices.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page (default 20, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"status": {
"description": "Only invoices with this status.",
"type": "string",
"enum": [
"sent",
"paid",
"credited"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hobok_get_invoice(local_id)
Fetch one invoice with its lines, totals, status and emails sent. GET /v1/invoices/{local_id}.
Input Schema
{
"type": "object",
"properties": {
"local_id": {
"type": "string",
"minLength": 1,
"description": "The invoice's local_id, as returned by hobok_list_invoices or hobok_create_invoice."
}
},
"required": [
"local_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hobok_create_invoice(client_id, buyer, issue_date, due_date, our_reference, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"client_id": {
"description": "Id of an existing customer (from hobok_list_clients).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"buyer": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Buyer name or company name."
},
"co_address": {
"description": "c/o address line.",
"type": "string"
},
"street_address": {
"description": "Street and house number.",
"type": "string"
},
"postal_code": {
"description": "Postal code.",
"type": "string"
},
"city": {
"description": "City.",
"type": "string"
},
"email": {
"description": "Buyer email address.",
"type": "string"
},
"phone": {
"description": "Buyer phone number.",
"type": "string"
}
},
"required": [
"name"
],
"description": "A one-off buyer, copied onto the invoice. Use either this or client_id, not both."
},
"issue_date": {
"description": "Issue date yyyy-mm-dd (default: today, set by Hobok).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_date": {
"description": "Due date yyyy-mm-dd. Default: issue date plus the account's payment terms.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"our_reference": {
"description": "Your reference, printed on the invoice.",
"type": "string"
},
"their_reference": {
"description": "The buyer's reference, printed on the invoice.",
"type": "string"
},
"notes": {
"description": "Notes printed on the invoice.",
"type": "string"
},
"lines": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"description": "Line text."
},
"quantity": {
"type": "number",
"description": "Quantity."
},
"unit": {
"description": "Unit, e.g. st, h, km.",
"type": "string"
},
"unit_price": {
"type": "number",
"description": "Price per unit in SEK."
},
"vat_rate": {
"description": "Only 0 is accepted. Any other value is rejected.",
"type": "number",
"const": 0
}
},
"required": [
"description",
"quantity",
"unit_price"
]
},
"description": "Invoice lines. At least one."
},
"send_email": {
"description": "Email the invoice to the buyer now. Default false. A sent email cannot be recalled; set true only when the user asks.",
"type": "boolean"
},
"email_message": {
"description": "Plain-text email body. Used only when send_email is true.",
"type": "string"
},
"idempotency_key": {
"description": "Your own key for this request. Retrying with the same key returns the first answer. If you omit it, the server derives one from the request.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hobok_mark_invoice_paid(local_id, payment_date, payment_method, payment_reference, send_receipt_email, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"local_id": {
"type": "string",
"minLength": 1,
"description": "The invoice's local_id, as returned by hobok_list_invoices or hobok_create_invoice."
},
"payment_date": {
"description": "Payment date yyyy-mm-dd (default: today, set by Hobok).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"payment_method": {
"description": "A value from hobok_list_payment_methods.",
"type": "string"
},
"payment_reference": {
"description": "Payment reference, e.g. a bank reference or OCR number.",
"type": "string"
},
"send_receipt_email": {
"description": "Email the receipt to the buyer. Default false. A sent email cannot be recalled; set true only when the user asks.",
"type": "boolean"
},
"idempotency_key": {
"description": "Your own key for this request. Retrying with the same key returns the first answer. If you omit it, the server derives one from the request.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"local_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hobok_email_receipt(local_id)
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.
Input Schema
{
"type": "object",
"properties": {
"local_id": {
"type": "string",
"minLength": 1,
"description": "The invoice's local_id, as returned by hobok_list_invoices or hobok_create_invoice."
}
},
"required": [
"local_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hobok_list_clients(page, per_page)
List the saved customers of the hobby business. Use an id from this list as client_id in hobok_create_invoice. GET /v1/clients.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page (default 20, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hobok_create_client(name, co_address, street_address, postal_code, city, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Customer name or company name."
},
"co_address": {
"description": "c/o address line.",
"type": "string"
},
"street_address": {
"description": "Street and house number.",
"type": "string"
},
"postal_code": {
"description": "Postal code.",
"type": "string"
},
"city": {
"description": "City.",
"type": "string"
},
"email": {
"description": "Email address.",
"type": "string"
},
"phone": {
"description": "Phone number.",
"type": "string"
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hobok_list_products(page, per_page)
List the saved products and services of the hobby business, with their prices. GET /v1/products.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page (default 20, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hobok_create_product(name, unit_price, description, unit)
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.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Product or service name."
},
"unit_price": {
"type": "number",
"description": "Price per unit in SEK. Required."
},
"description": {
"description": "Description.",
"type": "string"
},
"unit": {
"description": "Unit, e.g. st, h.",
"type": "string"
}
},
"required": [
"name",
"unit_price"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence