Hobok MCP by usefulapi

Read invoices, customers and products; issue invoices and record payments in Hobok.

Should I use this

Quality & Safety

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

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,399Tokens (tool definitions)
~1.6 KBTypical response size
Moderate attention impact (1.87% 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": {
    "hobok": {
      "url": "https://hobok.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://hobok.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools