everbill MCP by usefulapi

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

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
92%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,888토큰 (도구 정의)
~1.7 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.26%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 13개