everbill MCP by usefulapi

Read and create bills, customers and articles, and send bills by email in everbill.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
92%
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,888Tokens (Tool-Definitionen)
~1.7 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.26% 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": {
    "everbill": {
      "url": "https://everbill.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (13)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢everbill_check_connection

Check that the everbill API key still works. Exchanges the key for an access token and calls GET /check_token. Returns the vendor's reply.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_list_bills(limit)

List the bills (invoices) of the account. Each item has the bill data (status, number, date, customer). The spec documents no filters or pages, so the list can be large; use limit. GET /bills/index.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Return at most this many items (client-side trim).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_get_bill(bill_id)

Get one bill by its id with its customer, address, articles (line items) and transactions (payments). GET /bills/view/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "bill_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric everbill id."
    }
  },
  "required": [
    "bill_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_get_bill_pdf(number)

Download the PDF of a bill by its document number. Returns { number, filename, byteLength, pdfBase64 }. GET /bills/get_pdf/{number}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Document number, for example from everbill_list_bills."
    }
  },
  "required": [
    "number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_list_customers(limit)

List the customers of the account. The spec documents no filters or pages; use limit. GET /customers/index.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Return at most this many items (client-side trim).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_get_customer(customer_id)

Get one customer by id with its contact person and tags. GET /customers/view/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric everbill id."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_search_customers(field, value)

Find customers whose one field equals a value. `field` is an everbill customer field name (the spec does not list them; test a known value first). POST /customers/search_by_field.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "field": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Customer field name to match, for example email."
    },
    "value": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Value to match."
    }
  },
  "required": [
    "field",
    "value"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴everbill_create_customer(name, email, street, zipcode, location, ...)

Create a customer. Only `name` is required. Creates a new customer record each time it is called (no duplicate check). POST /customers/add.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Customer name (required)."
    },
    "email": {
      "description": "Customer email address.",
      "type": "string",
      "maxLength": 255,
      "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,}$"
    },
    "street": {
      "description": "Street and house number.",
      "type": "string",
      "maxLength": 4000
    },
    "zipcode": {
      "description": "Postal code.",
      "type": "string",
      "maxLength": 4000
    },
    "location": {
      "description": "City.",
      "type": "string",
      "maxLength": 4000
    },
    "phone1": {
      "description": "Phone number.",
      "type": "string",
      "maxLength": 4000
    },
    "website": {
      "description": "Website.",
      "type": "string",
      "maxLength": 4000
    },
    "uid": {
      "description": "VAT or company id (sent as UID).",
      "type": "string",
      "maxLength": 4000
    },
    "notes": {
      "description": "Internal notes.",
      "type": "string",
      "maxLength": 4000
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴everbill_create_bill(customer, items, date, status, currency, ...)

Create a bill (invoice) with its line items. Default status ZUVS (to send). Each call creates a new bill. For an existing customer, pass customer.id from everbill_list_customers or everbill_get_customer. POST /bills/add.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "customer": {
      "type": "object",
      "properties": {
        "id": {
          "description": "Existing customer id, if the customer already exists.",
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255,
          "description": "Customer name (required)."
        },
        "email": {
          "type": "string",
          "maxLength": 255,
          "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,}$"
        },
        "street": {
          "description": "Street and house number.",
          "type": "string",
          "maxLength": 4000
        },
        "zipcode": {
          "description": "Postal code.",
          "type": "string",
          "maxLength": 4000
        },
        "location": {
          "description": "City.",
          "type": "string",
          "maxLength": 4000
        },
        "uid": {
          "description": "VAT or company id (sent as UID).",
          "type": "string",
          "maxLength": 4000
        }
      },
      "required": [
        "name"
      ],
      "description": "The customer the bill is for."
    },
    "items": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Line item name (required)."
          },
          "quantity": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Quantity (required)."
          },
          "price": {
            "type": "number",
            "description": "Unit price, net or gross as set by brutto (required)."
          },
          "ust": {
            "description": "VAT rate in percent, for example 20.",
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "unit": {
            "description": "Unit, for example Stk or h.",
            "type": "string",
            "maxLength": 32
          },
          "description": {
            "description": "Line item description.",
            "type": "string",
            "maxLength": 4000
          },
          "article_id": {
            "description": "Existing article id, if any.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "name",
          "quantity",
          "price"
        ]
      },
      "description": "Line items (at least one)."
    },
    "date": {
      "description": "Bill date, yyyy-mm-dd. Default: today (UTC).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "status": {
      "description": "Bill status code. Default ZUVS (to send).",
      "type": "string",
      "enum": [
        "ZUVS",
        "ZERW",
        "ZERF",
        "TERF",
        "ZUEF",
        "UEB",
        "STO",
        "MF",
        "M1",
        "M2",
        "M3",
        "INKS",
        "RKG"
      ]
    },
    "currency": {
      "description": "ISO currency code. Default EUR.",
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "ust": {
      "description": "VAT mode: 0 calculate VAT (default), 1 no VAT, 2 EU invoice, 3 foreign, 4 reverse charge.",
      "type": "integer",
      "minimum": 0,
      "maximum": 4
    },
    "brutto": {
      "description": "true for a gross bill, false (default) for a net bill.",
      "type": "boolean"
    },
    "introduction_text": {
      "description": "Text before the line items.",
      "type": "string",
      "maxLength": 4000
    },
    "finish_text": {
      "description": "Text after the line items.",
      "type": "string",
      "maxLength": 4000
    },
    "payment_terms_text": {
      "description": "Payment terms text.",
      "type": "string",
      "maxLength": 4000
    },
    "service_period_from_date": {
      "description": "Service period start, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "service_period_to_date": {
      "description": "Service period end, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "customer",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴everbill_send_bill_email(number, sender_mail, sender_name, user_id, filename)

Send a bill PDF by email to its customer, from sender_mail / sender_name. This sends a real email to a real customer. user_id defaults to the account user id. POST /bills/send_mail/{number}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Document number, for example from everbill_list_bills."
    },
    "sender_mail": {
      "type": "string",
      "maxLength": 255,
      "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,}$",
      "description": "Sender email address (required)."
    },
    "sender_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Sender name (required)."
    },
    "user_id": {
      "description": "everbill user id. Default: the account user id of the API key.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "filename": {
      "description": "PDF file name in the email.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    }
  },
  "required": [
    "number",
    "sender_mail",
    "sender_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_list_articles(limit)

List the articles (products and services) of the account. The spec documents no filters or pages; use limit. GET /articles/index.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Return at most this many items (client-side trim).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢everbill_get_article(article_id)

Get one article by id, with its prices, VAT and stock fields. GET /articles/view/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "article_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric everbill id."
    }
  },
  "required": [
    "article_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴everbill_create_article(name, article_number, ean, unit, description, ...)

Create an article (product or service) with its name, unit and net price. Each call creates a new article. POST /articles/add.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Article name (required)."
    },
    "article_number": {
      "description": "Your article number.",
      "type": "string",
      "maxLength": 4000
    },
    "ean": {
      "description": "EAN or barcode.",
      "type": "string",
      "maxLength": 4000
    },
    "unit": {
      "description": "Unit, for example Stk or h.",
      "type": "string",
      "maxLength": 32
    },
    "description": {
      "description": "Article description.",
      "type": "string",
      "maxLength": 4000
    },
    "base_price": {
      "description": "Net unit price.",
      "type": "number"
    },
    "ust": {
      "description": "VAT rate in percent, for example 20.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "article_category_id": {
      "description": "Existing article category id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet13 Tools