everbill MCP by usefulapi
Read and create bills, customers and articles, and send bills by email in everbill.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"everbill": {
"url": "https://everbill.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://everbill.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(13)
🟢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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス