Hobok MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
98%
Vollständigkeit des Schemas
85%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,399Tokens (Tool-Definitionen)
~1.6 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (1.87% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "hobok": {
      "url": "https://hobok.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (11)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-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.

Eingabe-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.

Eingabe-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}.

Eingabe-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.

Eingabe-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.

Eingabe-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.

Eingabe-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.

Eingabe-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.

Eingabe-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.

Eingabe-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.

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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet11 Tools